# Roost

Roost is a single Docker container for homelab users that hosts remote coding agents such as Claude Code, Codex, and opencode, keeping them running after you close your laptop; you can drive them over SSH with herdr. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7112/roost

## Description

Roost is a single Docker container for homelab users that hosts remote coding agents such as Claude Code, Codex, and opencode, keeping them running after you close your laptop; you can drive them over SSH with herdr from any machine or phone using public-key-only access and no Docker socket.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

38/100 (Low), based on 4 of 4 factors.
- Maintained: 75 (last commit 5 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (8 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/app_e4212de767d29e3f
- GitHub: https://github.com/aronjanosch/roost
- Documentation: https://herdr.dev

## Common questions

### What are the SSH connection details for roost?

Use SSH port 2222 as the user agent with pubkey-only authentication. Add your public key(s), comma-separated, to PUBLIC_KEYS before connecting.

### Does roost take a while to become ready on first start?

Yes, the first start installs harnesses, herdr, gh and glab, headless Chromium and Playwright MCP via mise, which can take a few minutes. Check the log for progress.

### How can I move existing agent logins into roost?

Use the included roost-migrate script to copy logins from your laptop into the container. It asks per group and does not copy private keys.

### How do I update roost without losing existing data?

Run docker compose pull and docker compose up -d. Logins, repos and tools remain in the volume, but running agent sessions stop during the container recreate.

### Can I use roost from my phone or outside my local network?

Any SSH app works with the same host, port 2222, user agent and your key, but the phone must reach the host via the same LAN or a VPN such as Tailscale. Do not expose port 2222 to the internet.

---
Source: Our Local Host (https://ourlocalhost.com/app/7112/roost), the self-hosted and open-source app directory.