{"id":5591,"date":"2026-07-12T19:12:23","date_gmt":"2026-07-12T19:12:23","guid":{"rendered":"https:\/\/blog.gordonbuchan.com\/blog\/?p=5591"},"modified":"2026-07-12T21:04:34","modified_gmt":"2026-07-12T21:04:34","slug":"installing-and-configuring-an-openhands-agent-connected-to-an-llm-inference-service","status":"publish","type":"post","link":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/2026\/07\/12\/installing-and-configuring-an-openhands-agent-connected-to-an-llm-inference-service\/","title":{"rendered":"Installing and configuring an OpenHands agent connected to an LLM inference service"},"content":{"rendered":"\n

In this procedure we install and configure an OpenHands<\/a> agent connected to an LLM inference service. The OpenHands agent is hosted on a virtual machine (VM) under virt-manager<\/a> and is connected to an inference service backend hosted by DeepInfra<\/a>, serving the model Qwen3.5 397B-A17B<\/a>, via OpenHands’ built-in LiteLLM integration. Tested on Ubuntu Desktop 24.04 LTS (Noble Numbat)<\/a>.<\/p>\n\n\n\n

Note re Ubuntu Desktop 26.04: At the time of this writing there was a bug in the remote desktop server, making Ubuntu Desktop 26.04 unsuitable for this exercise.<\/p>\n\n\n\n

Understanding OpenHands<\/h2>\n\n\n\n


OpenHands is a coding agent designed for software engineering tasks: reading and editing files, running shell commands, writing and running tests, opening pull requests (PRs). It can also be given a procedure document and a target VM and asked to execute the installation via SSH from inside its sandbox.<\/p>\n\n\n\n

OpenHands web interface<\/h3>\n\n\n\n
\"\"<\/figure>\n\n\n\n

The architecture has two components. The controller process manages the agent loop and handles LLM abstraction via its built-in LiteLLM. The sandbox is a Docker container spawned per task: the agent’s code, shell commands, and file writes all run inside the sandbox, isolated from the host VM.<\/p>\n\n\n\n

KVM host          \u2192  openhands01  (Ubuntu Desktop VM)
                       \u251c\u2500 OpenHands controller  (port 3000, web UI)
                       \u2502    \u2514\u2500 Built-in LiteLLM \u2192 DeepInfra \u2192 Qwen3.5-397B-A17B
                       \u2514\u2500 Docker sandbox containers  (spawned per task)<\/pre>\n\n\n\n
OpenHands vs OpenClaw vs Hermes<\/h2>\n\n\n\n
OpenClaw<\/a>: sysadmin agent, browser automation, SSH deployments, approval gates.
Hermes<\/a>: sysadmin agent, cron scheduling, persistent memory, SSH backends, reusable skills.
OpenHands<\/a>: coding agent, file editing, test running, SSH deployments from sandbox. Docker<\/a> required. LiteLLM built in: no separate proxy needed. No skills system. No persistent memory across tasks. Reusable procedures are documents in the workspace directory.<\/p>\n\n\n\n
Creating a DeepInfra account<\/h2>\n\n\n\n
OpenHands connects directly to DeepInfra through its built-in LiteLLM. You only need one API key.
Navigate to https:\/\/deepinfra.com<\/a> and create an account.
Go to Dashboard \u2192 Billing \/ Credits \u2192 Add Credit. Add US $10.
Navigate to Dashboard \u2192 API Keys \u2192 Create API Key. Copy the key.<\/p>\n\n\n\n
Verifying the key with curl<\/h3>\n\n\n\n
curl https:\/\/api.deepinfra.com\/v1\/openai\/chat\/completions \\
  -H 'Authorization: Bearer YOUR_DEEPINFRA_KEY' \\
  -H 'Content-Type: application\/json' \\
  -d '{
    \"model\": \"Qwen\/Qwen3.5-397B-A17B\",
    \"messages\": [{\"role\": \"user\", \"content\": \"Say hello in French.\"}]
  }'<\/pre>\n\n\n\n
Expected: valid JSON with a choices array. Do not proceed until this returns a valid response.<\/p>\n\n\n\n
Creating the virtual machine<\/h2>\n\n\n\n
In this procedure, OpenHands<\/a> runs inside an Ubuntu Desktop 24.04 Noble Numbat)<\/a> VM on a server running virt-manager<\/a>\/KVM\/Qemu. You can use other virtualization platforms, such as VMware<\/a>, Hyper-V<\/a>, Proxmox<\/a>, Parallels, or a cloud platform (VirtualBox<\/a> is not recommended for performance reasons). Docker<\/a> runs inside the VM. Ubuntu Desktop is used so you can watch the web UI on screen. The virtual machine is accessed by SSH and remote desktop software such as remmina.<\/p>\n\n\n\n
Specifications for the virtual machine<\/h3>\n\n\n\n
Ubuntu Desktop 24.04 ISO.
RAM: 16384 MB, CPU: 4 vCPU, Disk: 100 GB.
Hardware: CPU model host-passthrough, Disk bus VirtIO, NIC VirtIO bridged, Display Spice or QXL.<\/p>\n\n\n\n
Notes: Configure the virtual machine with a static IP address, enable SSH and remote desktop access. enable auto-login and disable screen lock and screen timeouts. Hint: enter the command sudo ufw allow 3389\/tcp to expose the remote desktop through the virtual machine’s firewall.<\/p>\n\n\n\n
Creating a snapshot (“fresh-install”)<\/h3>\n\n\n\n
Create a snapshot called fresh-install. for virt-manager, the commands from the hypervisor host are:<\/p>\n\n\n\n
(from the hypervisor host)

virsh shutdown openhands01 && virsh domstate openhands01
virsh snapshot-create-as openhands01 fresh-install \\
  --description 'Clean Ubuntu Desktop, no packages' --atomic
virsh start openhands01<\/pre>\n\n\n\n
Setting up the base OS<\/h2>\n\n\n\n
Updating the system<\/h3>\n\n\n\n
sudo apt update
sudo apt full-upgrade -y
sudo reboot<\/pre>\n\n\n\n
Installing dependencies<\/h3>\n\n\n\n
sudo apt install -y \\
  curl git jq htop tmux \\
  build-essential ca-certificates gnupg \\
  python3 python3-pip python3.12-venv \\
  openssh-client openssh-server \\
  qemu-guest-agent<\/pre>\n\n\n\n
Installing Google Chrome<\/h3>\n\n\n\n
Do not install chromium-browser via apt: it installs a snap stub. Install the official Chrome deb:<\/p>\n\n\n\n
wget https:\/\/dl.google.com\/linux\/direct\/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y
google-chrome --version<\/pre>\n\n\n\n
Enabling services and rebooting<\/h3>\n\n\n\n
sudo systemctl enable --now qemu-guest-agent
sudo systemctl enable --now ssh
sudo reboot<\/pre>\n\n\n\n
Creating a snapshot (“base-os”)<\/h3>\n\n\n\n
Create a snapshot called base-os. For virt-manager, the commands from the hypervisor host are:<\/p>\n\n\n\n
(from the hypervisor)

virsh shutdown openhands01 && virsh domstate openhands01
virsh snapshot-create-as openhands01 base-os \\
  --description 'Base OS packages installed, pre-Docker' --atomic
virsh start openhands01<\/pre>\n\n\n\n
Installing Docker<\/h2>\n\n\n\n
Docker is required. OpenHands spawns sandbox containers for each task via the Docker socket. Without it the agent loop fails immediately.<\/p>\n\n\n\n
Installing Docker Engine<\/h3>\n\n\n\n
sudo install -m 0755 -d \/etc\/apt\/keyrings
curl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg | \\
  sudo gpg --dearmor -o \/etc\/apt\/keyrings\/docker.gpg
sudo chmod a+r \/etc\/apt\/keyrings\/docker.gpg
 
echo \\
  \"deb [arch=$(dpkg --print-architecture) \\
  signed-by=\/etc\/apt\/keyrings\/docker.gpg] \\
  https:\/\/download.docker.com\/linux\/ubuntu \\
  $(. \/etc\/os-release && echo \"$VERSION_CODENAME\") stable\" | \\
  sudo tee \/etc\/apt\/sources.list.d\/docker.list > \/dev\/null
 
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin
sudo systemctl enable --now docker
sudo docker run hello-world<\/pre>\n\n\n\n
Adding desktop to the docker group<\/h3>\n\n\n\n
sudo usermod -aG docker desktop<\/pre>\n\n\n\n
Log out and back in is required<\/h4>\n\n\n\n
Docker group membership does not take effect in existing shell sessions. Log out of the desktop session completely and log back in. Verify with: docker run hello-world (no sudo). If you skip this step openhands serve will fail with permission denied on the Docker socket.<\/p>\n\n\n\n
Creating a snapshot (“docker-installed”)<\/h3>\n\n\n\n
Create a snapshot called fresh-install. for virt-manager, the commands from the hypervisor host are:<\/p>\n\n\n\n
(from the hypervisor host)

virsh shutdown openhands01 && virsh domstate openhands01
virsh snapshot-create-as openhands01 docker-installed \\
  --description 'Docker installed and verified' --atomic
virsh start openhands01<\/pre>\n\n\n\n
Installing uv and OpenHands<\/h2>\n\n\n\n
OpenHands is installed via uv. Do not use pip install openhands-ai that is the legacy V0 SDK and will not work.<\/p>\n\n\n\n
Installing uv<\/h3>\n\n\n\n
curl -LsSf https:\/\/astral.sh\/uv\/install.sh | sh
source ~\/.bashrc
uv --version<\/pre>\n\n\n\n
Installing OpenHands<\/h3>\n\n\n\n
uv tool install openhands --python 3.12
openhands --version<\/pre>\n\n\n\n
Creating workspace and SSH directories<\/h3>\n\n\n\n
mkdir -p ~\/openhands-workspace
mkdir -p ~\/.openhands
mkdir -p ~\/openhands-workspace\/.ssh<\/pre>\n\n\n\n
Creating a snapshot (“post-install”)<\/h3>\n\n\n\n
Create a snapshot called base-os. For virt-manager, the commands from the hypervisor host are:<\/p>\n\n\n\n
(from the hypervisor)

virsh shutdown openhands01 && virsh domstate openhands01
virsh snapshot-create-as openhands01 openhands-installed \\
  --description 'OpenHands installed via uv, pre-config' --atomic
virsh start openhands01<\/pre>\n\n\n\n
Starting OpenHands for the first time<\/h2>\n\n\n\n
Run openhands serve once manually to pull the Docker images. This must happen in an interactive terminal session before the autostart is configured.<\/p>\n\n\n\n
cd ~\/openhands-workspace
openhands serve<\/pre>\n\n\n\n
On first run this pulls the openhands Docker image: several gigabytes. It will appear to hang at Pulling for several minutes. Wait for:<\/p>\n\n\n\n
\u2705 Starting OpenHands GUI server...
The server will be available at: http:\/\/localhost:3000<\/pre>\n\n\n\n
Do not kill the process during image pull<\/h4>\n\n\n\n
The first run pulls several GB of Docker images. If it appears to hang at Pulling for 5-10 minutes this is normal. Wait for the startup confirmation before opening the web UI.<\/p>\n\n\n\n
Open the web UI on the openhands01 desktop:<\/p>\n\n\n\n
http:\/\/localhost:3000<\/a><\/pre>\n\n\n\n
Configuring the model<\/h2>\n\n\n\n
The Settings page appears on first launch. Navigate to Settings \u2192 LLM \u2192 click the Advanced tab.<\/p>\n\n\n\n
How to access Settings<\/h4>\n\n\n\n
The gear icon in the sidebar navigates to a broken route (\/automations) in this version: ignore it. Access settings directly at: http:\/\/localhost:3000\/settings<\/a><\/p>\n\n\n\n
Entering the model details<\/h3>\n\n\n\n
Field<\/strong><\/td>Value<\/strong><\/td><\/tr>
Custom Model<\/td>openai\/Qwen\/Qwen3.5-397B-A17B<\/td><\/tr>
Base URL<\/td>https:\/\/api.deepinfra.com\/v1\/openai<\/td><\/tr>
API Key<\/td>your_deepinfra_key_here<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Click Save Changes. Settings are stored in ~\/.openhands\/settings.json.<\/p>\n\n\n\n
The openai\/ prefix is required<\/h4>\n\n\n\n
The openai\/ prefix tells LiteLLM to use the OpenAI-compatible request format. Without it, LiteLLM auto-detects the wrong format and produces cryptic 400 errors. Always enter openai\/Qwen\/Qwen3.5-397B-A17B.
The Basic tab shows named providers only: DeepInfra is not listed. The Advanced tab is the correct path.<\/p>\n\n\n\n
Testing the connection<\/h3>\n\n\n\n
Start a new conversation and send:<\/p>\n\n\n\n
Say hello in French.<\/pre>\n\n\n\n
Expected: Bonjour. The first response may take 30-60 seconds while the sandbox container starts. If the agent produces no response at all, see next section.<\/p>\n\n\n\n
Streaming troubleshooting<\/h2>\n\n\n\n
If the agent produces no response or an empty response, DeepInfra’s streaming implementation may be causing empty SSE responses: the same issue that affected OpenClaw and Hermes. Add disable_streaming = true to ~\/.openhands\/config.toml:<\/p>\n\n\n\n
nano ~\/.openhands\/config.toml<\/pre>\n\n\n\n
[llm]
disable_streaming = true<\/pre>\n\n\n\n
Restart OpenHands and test again. If disable_streaming = true resolves it, leave it in place, it has no effect on agent capability.<\/p>\n\n\n\n
To restart:<\/p>\n\n\n\n
# Ctrl+C in the terminal running openhands serve, then:
openhands serve<\/pre>\n\n\n\n
Persisting across reboots<\/h2>\n\n\n\n
openhands serve calls docker run -it which requires an interactive TTY. Neither rc.local nor systemd services provide a TTY at boot time: both fail with ‘cannot attach stdin to a TTY-enabled container’. The reliable solution for a Desktop VM accessed via RDP is a GNOME desktop autostart entry, which fires when the desktop session starts and has a proper TTY context.<\/p>\n\n\n\n
Creating the autostart entry<\/h3>\n\n\n\n
Stop openhands serve first (Ctrl+C), then:<\/p>\n\n\n\n
mkdir -p ~\/.config\/autostart
nano ~\/.config\/autostart\/openhands.desktop<\/pre>\n\n\n\n
Paste the following:<\/p>\n\n\n\n
[Desktop Entry]
Type=Application
Name=OpenHands
Exec=\/home\/desktop\/.local\/bin\/openhands serve
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true<\/pre>\n\n\n\n
Why desktop autostart and not rc.local or systemd<\/h4>\n\n\n\n
openhands serve uses docker run -it which requires a controlling terminal. rc.local and systemd both start without a terminal and fail immediately. The GNOME autostart mechanism runs after the desktop session initialises: it has a full terminal environment and docker run -it succeeds.<\/p>\n\n\n\n
Rebooting and verifying<\/h3>\n\n\n\n
sudo reboot<\/pre>\n\n\n\n
Log back into openhands01 via RDP. Wait one minute for OpenHands to start automatically, then verify:<\/p>\n\n\n\n
docker ps | grep openhands
curl http:\/\/localhost:3000<\/pre>\n\n\n\n
Open the web UI at http:\/\/localhost:3000<\/a> and confirm the model responds.<\/p>\n\n\n\n
Creating a snapshot (“post-rebooting”)<\/h3>\n\n\n\n
Create a snapshot called base-os. For virt-manager, the commands from the hypervisor host are:<\/p>\n\n\n\n
(from the hypervisor)

virsh shutdown openhands01 && virsh domstate openhands01
virsh snapshot-create-as openhands01 openhands-configured \\
  --description 'OpenHands configured, working, reboot-verified' --atomic
virsh start openhands01<\/pre>\n\n\n\n
Watching the browser work<\/h2>\n\n\n\n
OpenHands browser automation runs via Playwright inside the Docker sandbox container. There is no visible Chrome window on the openhands01 desktop: the sandbox has no display. All browser activity is observable through the web UI event log, where every navigation, click, and screenshot appears inline in the conversation.<\/p>\n\n\n\n
There is no browser toggle in Settings,  browser capability is built into the sandbox and always available in this version.<\/p>\n\n\n\n
Testing browser automation<\/h3>\n\n\n\n
Start a new conversation in the web UI and submit:<\/p>\n\n\n\n
Go to https:\/\/example.com and tell me the page title and main heading.<\/pre>\n\n\n\n
Watch the event log on the right side of the UI. You should see browser_navigate, browser_snapshot, and the page content returned inline.<\/p>\n\n\n\n
No visible Chrome window: this is expected<\/h4>\n\n\n\n
OpenHands browser automation is headless inside the Docker sandbox. This is different from Hermes and OpenClaw where Chrome opens visibly on the desktop. The web UI event log and inline screenshots give full visibility into what the agent is doing.<\/p>\n\n\n\n
Giving the sandbox SSH access to a remote VM<\/h2>\n\n\n\n
When OpenHands SSHes to a remote VM, the connection runs from inside the sandbox container. The sandbox needs a key that the target trusts as root. Place the key inside the workspace directory: mounted into the sandbox at \/workspace: and authorize it on the target before starting the task.<\/p>\n\n\n\n
Generating a dedicated key pair<\/h3>\n\n\n\n
ssh-keygen -t ed25519 -C 'openhands-sandbox' \\
  -f ~\/openhands-workspace\/.ssh\/openhands_sandbox
# Press Enter twice: no passphrase<\/pre>\n\n\n\n
Authorizing the key on the target VM<\/h3>\n\n\n\n
ssh-copy-id -i ~\/openhands-workspace\/.ssh\/openhands_sandbox.pub root@192.168.x.x
 
# Verify passwordless root access
ssh -i ~\/openhands-workspace\/.ssh\/openhands_sandbox root@192.168.x.x 'uname -a'<\/pre>\n\n\n\n
Root access via SSH key<\/h4>\n\n\n\n
The sandbox needs root on the target to install packages, configure services, and write to system directories. This key is scoped to OpenHands sandbox use: revoke it from authorized_keys on the target when the deployment is complete.<\/p>\n\n\n\n
Pre-populating known_hosts<\/h3>\n\n\n\n
Pre-populate to prevent SSH host key prompts stalling the agent mid-task:<\/p>\n\n\n\n
ssh-keyscan -H 192.168.x.x >> ~\/openhands-workspace\/.ssh\/known_hosts
chmod 600 ~\/openhands-workspace\/.ssh\/known_hosts<\/pre>\n\n\n\n
Running a deployment task<\/h2>\n\n\n\n
Provide to OpenHands a procedure document and a target VM and let it execute the installation.<\/p>\n\n\n\n
Placing the procedure in the workspace<\/h3>\n\n\n\n
cp \/path\/to\/procedure.md ~\/openhands-workspace\/<\/pre>\n\n\n\n
The task prompt<\/h3>\n\n\n\n
Submit this in the web UI: the prompt must be entirely self-contained since each sandbox starts fresh with no memory:<\/p>\n\n\n\n
Read the procedure in \/workspace\/procedure.md.
 
Connect to the target VM:
  Host: 192.168.x.x
  User: root
  SSH key: \/workspace\/.ssh\/openhands_sandbox
  Known hosts: \/workspace\/.ssh\/known_hosts
 
Execute the procedure exactly as written.
Verify each step succeeds before continuing.
If a step fails, stop and report the error.
 
When complete, provide a full status report:
what was installed, current state of each service,
and any issues encountered.<\/pre>\n\n\n\n
Self-contained prompts are mandatory<\/h4>\n\n\n\n
Each OpenHands task starts in a fresh sandbox with no memory of prior sessions. Include the target host, SSH key path, and procedure reference in every prompt.<\/p>\n\n\n\n
Running a first coding task<\/h2>\n\n\n\n
Create a test file and give the agent a scoped coding task to verify the full stack:<\/p>\n\n\n\n
cat > ~\/openhands-workspace\/utils.py << 'EOF'
def add(a, b):
    return a + b
 
def multiply(a, b):
    return a * b
EOF<\/pre>\n\n\n\n
In the web UI, submit:<\/p>\n\n\n\n
Add docstrings to both functions in utils.py.
Write a test file test_utils.py with pytest tests for both functions.
Run the tests and confirm they pass.<\/pre>\n\n\n\n
Watch the event log. You should see the agent read utils.py, write docstrings, create test_utils.py, and run pytest inside the sandbox. Files are visible in ~\/openhands-workspace on the host after the task completes.<\/p>\n\n\n\n
Verifying that the system survives a reboot<\/h2>\n\n\n\n
After the autostart is configured (section 9), reboot survival is automatic: log in via RDP and OpenHands starts. Confirm:<\/p>\n\n\n\n
# Docker starts on boot
systemctl is-enabled docker   # Expected: enabled
 
# Autostart entry is in place
cat ~\/.config\/autostart\/openhands.desktop<\/pre>\n\n\n\n
After any reboot, log back in via RDP, wait one minute, then:<\/p>\n\n\n\n
docker ps | grep openhands
curl http:\/\/localhost:3000<\/pre>\n\n\n\n
Known issues and fixes<\/h2>\n\n\n\n
Symptom<\/strong><\/td>Fix<\/strong><\/td><\/tr>
Gear icon in sidebar shows 404 Not Found<\/td>The gear icon links to \/automations which does not exist in this version. Access settings at http:\/\/localhost:3000\/settings<\/a> instead.<\/td><\/tr>
openhands serve hangs at Pulling for several minutes<\/td>Normal on first run: the Docker image is several GB. Wait for the startup confirmation.<\/td><\/tr>
pip install openhands-ai works but openhands command not found<\/td>openhands-ai is the legacy V0 SDK. Use: uv tool install openhands –python 3.12<\/td><\/tr>
Docker permission denied without sudo<\/td>Run: sudo usermod -aG docker desktop: then log out and back in completely.<\/td><\/tr>
~\/.openhands owned by root, permission errors<\/td>Caused by a previous sudo openhands run. Fix: sudo chown desktop:desktop ~\/.openhands<\/td><\/tr>
Agent produces no response from DeepInfra<\/td>Add disable_streaming = true to the [llm] section of ~\/.openhands\/config.toml and restart openhands serve.<\/td><\/tr>
Cryptic 400 error from DeepInfra<\/td>Missing openai\/ prefix. Use openai\/Qwen\/Qwen3.5-397B-A17B not Qwen\/Qwen3.5-397B-A17B.<\/td><\/tr>
rc.local or systemd service fails with ‘cannot attach stdin to a TTY-enabled container’<\/td>openhands serve hardcodes docker run -it which requires a TTY. Neither rc.local nor systemd provides one. Use the GNOME desktop autostart approach in section 9 instead.<\/td><\/tr>
OpenHands does not start after reboot<\/td>Check the autostart entry exists: cat ~\/.config\/autostart\/openhands.desktop. The autostart only fires when you log into the desktop session via RDP: OpenHands is not running before login.<\/td><\/tr>
SSH host key prompt stalls the agent mid-task<\/td>Pre-populate known_hosts: ssh-keyscan -H <target-ip> >> ~\/openhands-workspace\/.ssh\/known_hosts<\/td><\/tr>
Sandbox cannot find SSH key<\/td>The key must be inside ~\/openhands-workspace\/ it is mounted at \/workspace\/ in the sandbox. Keys elsewhere are not visible to the agent.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Snapshot reference<\/h2>\n\n\n\n
Snapshot<\/strong><\/td>Created after<\/strong><\/td><\/tr>
fresh-install<\/td>Ubuntu Desktop installed, no packages<\/td><\/tr>
base-os<\/td>All apt packages installed, pre-Docker<\/td><\/tr>
docker-installed<\/td>Docker installed and verified<\/td><\/tr>
openhands-installed<\/td>OpenHands installed via uv, pre-config<\/td><\/tr>
openhands-configured<\/td>Model configured, working, reboot-verified<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Maintaining the system ongoing<\/h2>\n\n\n\n
Task<\/strong><\/td>Frequency<\/strong><\/td><\/tr>
Check DeepInfra dashboard for spend<\/td>Weekly<\/td><\/tr>
Rotate DeepInfra API key via Settings \u2192 LLM \u2192 Advanced, restart openhands serve<\/td>Every 90 days<\/td><\/tr>
Upgrade OpenHands: uv tool upgrade openhands check release notes first<\/td>Monthly<\/td><\/tr>
Prune unused Docker images: docker image prune -f<\/td>Monthly<\/td><\/tr>
Revoke sandbox SSH keys from target VMs after deployments complete<\/td>After each deployment<\/td><\/tr>
Snapshot openhands01 after any significant config change<\/td>As needed<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Daily usage<\/h2>\n\n\n\n

OpenHands starts automatically when the gnome desktop session is started at bootup with autologin. Open a browser on the openhands01 desktop and navigate to http:\/\/localhost:3000<\/a>.<\/p>\n\n\n\n

To hand the agent a procedure document and a target VM:<\/p>\n\n\n\n
# Place the procedure in the workspace
cp procedure.md ~\/openhands-workspace\/
 
# Pre-populate known_hosts for the target
ssh-keyscan -H 192.168.x.x >> ~\/openhands-workspace\/.ssh\/known_hosts
 
# Open http:\/\/localhost:3000 and submit the task prompt<\/pre>\n\n\n\n
For a project session:<\/p>\n\n\n\n
cd ~\/myproject
openhands serve --mount-cwd<\/pre>\n\n\n\n
–mount-cwd for quick sessions<\/h4>\n\n\n\n
openhands serve –mount-cwd mounts the current directory into the sandbox as \/workspace. Use this for quick one-off sessions with a specific project without copying files into the workspace directory.<\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
In this procedure we install and configure an OpenHands agent connected to an LLM inference service. The OpenHands agent is hosted on a virtual machine (VM) under virt-manager and is connected to an inference service backend hosted by DeepInfra, serving the model Qwen3.5 397B-A17B, via OpenHands’ built-in LiteLLM integration. Tested on Ubuntu Desktop 24.04 LTS … <\/p>\n
Continue reading “Installing and configuring an OpenHands agent connected to an LLM inference service”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-5591","post","type-post","status-publish","format-standard","hentry","category-linux"],"_links":{"self":[{"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/posts\/5591","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/comments?post=5591"}],"version-history":[{"count":63,"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/posts\/5591\/revisions"}],"predecessor-version":[{"id":5657,"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/posts\/5591\/revisions\/5657"}],"wp:attachment":[{"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/media?parent=5591"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/categories?post=5591"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.gordonbuchan.com\/blog\/index.php\/wp-json\/wp\/v2\/tags?post=5591"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}