agent0/shared/knowledge/runbooks/start-gerhard.md

Runbook: start Gerhard on Omega13

Preconditions

Expected side-by-side layout:

~/Projects/Agent0
~/Projects/gutasktool

Local .env exists in Agent0 and contains non-committed credentials:

• API_URL
• CONTENT_API_KEY
• AGENT_ID
• AGENT_NAME
• AGENT_PASSWORD
• model provider keys as needed

SSH config/keys on the host can push to Gitea if Gerhard is expected to push repository changes.

Pull latest

cd ~/Projects/Agent0
git pull --ff-only
cd ../gutasktool
git pull --ff-only

Start Gerhard first

cd ~/Projects/Agent0
docker compose up -d gerhard gerhard-dashboard

Validate

docker compose ps gerhard gerhard-dashboard
docker logs gerhard --tail=100
docker logs gerhard-dashboard --tail=100

Check gutask wrapper:

docker compose exec gerhard /opt/data/bin/gutask --help
docker compose exec gerhard /opt/data/bin/gutask orient --agent "$AGENT_ID"

Check shared knowledge mount:

docker compose exec gerhard test -f /knowledge/README.md

Dashboard

Gerhard dashboard should be reachable from Omega13 at:

http://localhost:50007

Then tunnel and rest

Only after Gerhard is stable:

docker compose up -d glitch-tunnel
docker compose up -d