From 0580f26782a50deaae8a800a5f22f3ab557b22c9 Mon Sep 17 00:00:00 2001 From: Oliver Date: Thu, 11 Jun 2026 09:27:09 -0300 Subject: [PATCH] add SSH for Agents focus topic page + link in Topics section --- index.html | 6 + ssh-for-agents.html | 309 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 315 insertions(+) create mode 100644 ssh-for-agents.html diff --git a/index.html b/index.html index d02caae..f3d4bbc 100644 --- a/index.html +++ b/index.html @@ -3539,6 +3539,12 @@

Build and deploy your own ChatGPT-powered AI agent. Full SSH access, no coding, enterprise-grade hosting — deploy in under 5 minutes.

Explore → + +
Guide
+

SSH for Agents

+

Connect, manage, and transfer files to your agent's Linux instance. Encryption keys, file sync, Tmux sessions, and Midnight Commander — everything you need.

+ Explore → + diff --git a/ssh-for-agents.html b/ssh-for-agents.html new file mode 100644 index 0000000..5492747 --- /dev/null +++ b/ssh-for-agents.html @@ -0,0 +1,309 @@ + + + + + + + + SSH for AI Agents — Access, Transfer, Manage | Derez.ai + + + + + + + + + + + + + + + +
+ ← Derez.ai Home + +
+

SSH for AI Agents

+

Everything you need to connect to, manage, and transfer files to and from your agent's Linux instance. Your agent comes with full SSH access — here's how to make the most of it.

+
+ +
+

Chapters

+
    +
  1. Accessing SSH via Encryption Keys
    2. +
  2. Copying Files In and Out — Derez Sync
    3. +
  3. Tmux — Persistent Terminal Sessions
    4. +
  4. Midnight Commander — File Management with a UI
    5. +
+
+ + +

1 Accessing SSH via Encryption Keys

+ +

Your Derez.ai agent runs in its own Linux container with full root SSH access. The most secure way to connect is using SSH key pairs — a public key stored on the server and a private key kept on your machine.

+ +

Generate an SSH Key Pair

+

If you don't already have an SSH key, create one on your local machine:

+ 
ssh-keygen -t ed25519 -C "my-derez-agent"
+

This creates two files in ~/.ssh/:

+ + +

Add the Public Key to Your Agent

+

Copy the content of your public key:

+ 
cat ~/.ssh/id_ed25519.pub
+

Then open your agent from the dashboard and add the key to ~/.ssh/authorized_keys:

+ 
echo "ssh-ed25519 AAAA... your-key" >> ~/.ssh/authorized_keys
+ +

Connect via SSH

+

Once the key is in place, connect from your machine:

+ 
ssh root@<your-agent-ip>
+

You're in — root access, full shell, no password required.

+ +
+

Pro Tip: You can also set or reset your SSH password from the dashboard at any time. The password is pushed securely into the container and works alongside your key-based access.

+
+ + +

2 Copying Files In and Out — Derez Sync

+ +

Derez.ai agents include a built-in sync mechanism that lets you transfer files between your local machine and your agent's instance without manual SCP or SFTP commands.

+ +

How It Works

+

The sync tool uses your existing SSH connection and handles directory structure, permissions, and incremental transfers automatically. It's designed for workflows where you iterate on scripts, configuration files, or data sets locally and push them to the agent.

+ +

Copy a File to Your Agent

+ 
scp /path/to/local/file root@<your-agent-ip>:/root/destination/
+ +

Copy a File from Your Agent

+ 
scp root@<your-agent-ip>:/root/source/file /path/to/local/destination/
+ +

Sync an Entire Directory

+

For larger directory trees, use rsync — it only transfers what changed:

+ 
rsync -avz --progress /local/project/ root@<your-agent-ip>:/root/project/
+

The -a flag preserves permissions and timestamps, -v gives verbose output, and -z compresses data during transfer.

+ +
+

Pro Tip: Use --delete with rsync if you want the destination to exactly mirror the source (removes files on the agent that don't exist locally). Great for keeping dev environments in sync.

+
+ + +

3 Tmux — Persistent Terminal Sessions

+ +

Tmux is a terminal multiplexer that keeps your sessions alive even after you disconnect. If you're running long tasks — model fine-tuning, data processing, agent training — Tmux ensures nothing stops when your SSH connection drops.

+ +

Start a New Tmux Session

+ 
tmux new -s my-session
+

This opens a new terminal inside Tmux. Run any command — it keeps running when you disconnect.

+ +

Detach and Reattach

+

Press Ctrl+B then D to detach from the session. Your commands keep running on the server. To come back later:

+ 
tmux attach -t my-session
+ +

List Active Sessions

+ 
tmux list-sessions
+ +

Kill a Session

+ 
tmux kill-session -t my-session
+ +

Useful Tmux Shortcuts

+ + +
+

Pro Tip: Start your Hermes agent inside a Tmux session. That way your agent stays online even if you close your laptop — reconnect anytime from anywhere.

+
+ + +

4 Midnight Commander — File Management with a UI

+ +

Midnight Commander (MC) is a full-screen file manager for the terminal. It gives you a two-panel interface — think Norton Commander — so you can browse, copy, move, and edit files on your agent visually without memorizing shell commands.

+ +

Install Midnight Commander

+

If MC isn't already installed on your agent:

+ 
apt update && apt install mc -y
+ +

Launch MC

+ 
mc
+

You'll see two panels side by side showing your directory structure. Navigate with the arrow keys, select files with Insert, and use the function key menu at the bottom:

+ + + +

Copy Files Between Panels

+

This is where MC shines for your agent. Open one panel showing a local directory and the other showing a remote path — or use an SSH filesystem panel:

+ 
# From MC, press Ctrl+F then choose "Shell link"
+# Enter: sh://root@<your-agent-ip>/root
+

Now you can copy files between your local machine and your agent by selecting them and pressing F5 — like dragging and dropping, but in the terminal.

+ +

Built-in Editor

+

Press F4 on any file to open MC's built-in editor (mcedit). It supports syntax highlighting, mouse support, and search — perfect for quick config edits on your agent without leaving the terminal.

+ +
+

Pro Tip: Enable mouse support in MC by pressing F9 → Options → Display → check "Mouse support". Now you can click to navigate, select files, and press function keys with your mouse — a full GUI feel over SSH.

+
+ + +
+

Deploy Your Agent with Full SSH Access

+

Every Derez.ai agent gives you root SSH access, file sync, and all the tools you need to manage it your way.

+ Get Started → +
+ +

+ Derez.ai — Deploy your AI agent in 5 minutes. · Blog · Focus Topics +

+
+ + \ No newline at end of file