Skip to content
SupaCloud Docs
Select themeSelect language

Stand up SupaCloud in 15 minutes

This tutorial walks you, end to end, from a fresh checkout to signing in to your own SupaCloud. You will run two commands and open one URL.

  1. Configure secrets. Copy the standalone example and set a strong JWT secret and database password:

    Terminal window
    cp .env.example.standalone .env
    # edit .env: SUPACLOUD_JWT_SECRET (>= 32 bytes), POSTGRES_PASSWORD,
    #            SUPACLOUD_INITIAL_ADMIN_EMAILS

  2. Bring the stack up. The standalone overlay rides on the base compose file (base first):

    Terminal window
    docker compose -f docker-compose.yml -f compose.standalone.yml up -d --build

    The server waits for PostgreSQL to be healthy, then migrates the database on boot.

  3. Sign in. Open http://localhost:3001 and sign in with the email you put in SUPACLOUD_INITIAL_ADMIN_EMAILS. That account becomes the owner of a new organization and its first workspace.

You now have a working SupaCloud. Next, launch your first agent run.