Getting Started#

Prerequisites#

Configuration#

  1. Setup .env with secure secrets

    make setup

    This automatically:

    • Copies .env.example to .env

    • Generates secure random values for all secrets

    • Searches for your podman socket

    • Updates your .env file

  2. Add GitHub credentials

    Edit your .env file and add GitHub info:

    GITHUB_USERNAME=your_github_username
GITHUB_TOKEN=your_personal_token

    You can get a personal token from your GitHub account settings. Use a classic token with read:packages.

Starting services#

  1. Quick start

    make setup
# then fix your GITHUB_USERNAME/TOKEN in .env
make docker-up
make operators

  2. Access the application

    Open your browser to http://localhost:5173

    • Username: admin@example.com

    • Password: Check your .env file for FIRST_SUPERUSER_PASSWORD (auto-generated), or output from make docker-up

Stopping services#

  1. To stop services:

    make docker-down

  2. To stop and delete database (be careful):

    make clean

Now you should have the full stack running in docker. Go to launch agent.