Skip to main content
description: “Self-host Agentbot”

Installation

Run Agentbot locally or self-host on your own infrastructure.

Prerequisites

  • Node.js 22+
  • PostgreSQL database
  • Docker (for agent containers)

Local Development

Environment Variables

Docker Production

The init: true flag enables proper signal forwarding and prevents zombie processes (PID 1 handling). The HOME and TERM environment variables are required by the official OpenClaw image which runs as the node user. NODE_COMPILE_CACHE enables the Node.js compile cache for faster startup, and OPENCLAW_NO_RESPAWN=1 prevents the OpenClaw process from automatically respawning inside the container (Docker’s restart policy handles restarts instead).

Deployment

  1. Push code to GitHub
  2. Import project in Vercel
  3. Add environment variables
  4. Deploy

Railway

DigitalOcean

Use the One-Click App for Node.js and connect a managed PostgreSQL database.

Verify Installation

After deployment, visit:
  • Main app: https://your-domain.com
  • Health check: https://your-domain.com/api/health

Troubleshooting

Check your DATABASE_URL format:
Ensure your OAuth redirect URLs match:
  • Development: http://localhost:3000/api/auth/callback/github
  • Production: https://your-domain.com/api/auth/callback/github