Skip to main content

Quickstart

The fastest way to try nohup is Docker.

1. Run it​

git clone https://github.com/nohup/nohup
cd nohup
docker compose up -d

This builds and starts nohup on http://localhost:8787. The docker-compose.yml mounts:

  • nohup-data — the SQLite registry (workspaces, sessions, agent config),
  • ./workspaces — put the repos you want the agents to work in here,
  • ~/.claude and ~/.codex — your agent logins (read-only).

:::tip Prefer a binary? nohup also builds to a single self-contained executable (UI + API embedded). See Install. :::

2. Make sure the agents are logged in​

nohup drives Claude Code and Codex, which authenticate with their own subscriptions. Log in once on your host so the mounted config is authenticated — see Agents.

3. Add a workspace and start a session​

  1. Open the UI, click + New next to Workspaces, and point it at a repo (e.g. /workspaces/my-repo in Docker).
  2. Click the workspace, then New session, and pick an agent (Claude / Codex).
  3. Type a message. The agent works in an isolated git worktree inside that repo.

If nohup is reachable beyond localhost, require a login — see Auth:

docker compose run --rm nohup hash-password   # prints an argon2 hash
# put NOHUP_USERNAME + NOHUP_PASSWORD_HASH in your environment, then restart