Docker

Deploy the Omnigent server with Docker Compose. The stack includes the server and a Postgres database.

Quick start

cd deploy/docker
./bootstrap.sh          # generates DB password + cookie secret into .env
docker compose up -d    # Omnigent server + Postgres

Then connect your laptop:

omni login https://your-host
omni host https://your-host

Environment variables

Key variables in .env:

VariablePurpose
DATABASE_URLPostgres connection string
OMNIGENT_AUTH_ENABLEDEnable multi-user auth (default: 1 in Docker)
OMNIGENT_OIDC_COOKIE_SECRETSession cookie secret
OMNIGENT_OIDC_ISSUEROIDC issuer URL (enables SSO)
OMNIGENT_OIDC_CLIENT_IDOIDC client ID
OMNIGENT_OIDC_CLIENT_SECRETOIDC client secret

No admin password is auto-generated. On first boot the server reports needs_setup: open the web UI and create the admin account there, or set OMNIGENT_ACCOUNTS_INIT_ADMIN_PASSWORD in .env to preset it for headless deploys.