Docker Setup

The easiest way to self-host AgentSudo is with Docker Compose. This sets up everything you need including the database, auth, and dashboard.

Prerequisites

• Docker and Docker Compose installed
• Node.js 18+ (for the setup script)
• Git

Quick Start

# Clone the repository
git clone https://github.com/xywa23/agentsudo
cd agentsudo

# Run setup (creates .env files, installs dependencies)
./setup.sh

# Start all services
docker compose up

Services

The Docker Compose setup includes:

Configuration

Environment Variables

Create a .env file in the project root. See Environment Variables for all options.

Custom Ports

Edit docker-compose.yml to change port mappings:

services:
  dashboard:
    ports:
      - "8080:3000"  # Change 8080 to your preferred port

Production Deployment

For production, we recommend:

1. Use Supabase Cloud for the database (managed, scalable)
2. Deploy dashboard to Vercel or your preferred host
3. Enable HTTPS with a reverse proxy (nginx, Caddy)

See Production Guide for details.

Troubleshooting

Database connection issues

# Check if Supabase is running
docker compose ps

# View logs
docker compose logs supabase-db

Dashboard not loading

# Rebuild the dashboard
docker compose build dashboard
docker compose up dashboard

Next Steps

• Environment Variables
• Database Migrations