Self-Hosting Overview

Deploy AgentSudo on your own infrastructure

AgentSudo is fully open source and can be self-hosted on your own infrastructure. This gives you complete control over your data and deployment.

Architecture

AgentSudo consists of three main components:

  1. SDK - Python library for permission control (pip install agentsudo)
  2. Dashboard - Next.js web application for management
  3. Database - PostgreSQL with Supabase for auth and storage

Deployment Options

Option 1: Docker Compose (Recommended)

The fastest way to get started. Includes everything you need:

git clone https://github.com/xywa23/agentsudo
cd agentsudo
./setup.sh
docker compose up

See Docker Setup for details.

Option 2: Supabase Cloud + Self-hosted Dashboard

Use Supabase's managed database with your own dashboard:

  1. Create a project at supabase.com
  2. Run the database migrations
  3. Deploy the dashboard to Vercel/Netlify

Option 3: Fully Custom

Deploy each component separately:

  • Dashboard → Vercel, Netlify, or any Node.js host
  • Database → Any PostgreSQL instance
  • Auth → Supabase Auth or your own solution

Quick Start

  1. Clone the repository:

    git clone https://github.com/xywa23/agentsudo
cd agentsudo

  2. Run the setup script:

    ./setup.sh

  3. Start the services:

    docker compose up

  4. Access the dashboard at http://localhost:3000

Next Steps