Skip to main content

Try it on your laptop

The fastest way to see Cortega: run it on your own machine with Docker Desktop. This is the same install path as Existing environment, just pointed at your laptop instead of a server. There's no separate trial build.

Prerequisites​

  • Docker Desktop (or Docker Engine + Compose v2) running locally.
  • Network access to pull the container images.

1. Configure​

cp deploy/.env.example .env
cp .env.provider-keys.example .env.provider-keys   # optional: your model provider keys

Edit .env: set INSTALL_TOPOLOGY=single, generate the secret values with openssl rand -hex 32, and pin a real release tag for the images.

2. Bring it up​

docker compose --env-file .env -f deploy/docker-compose.aws-core.yml \
  -f deploy/docker-compose.aws-gateway.yml up -d

The database sets itself up on first boot. There's no separate migration step to run.

3. Open it​

curl -f http://localhost:8001/api/v1/health

Open http://localhost in your browser and sign in with the default admin credentials from Install overview.

Next​

Once you're past a first look, Existing environment covers the full set of configuration variables for a real deployment, and AWS or Terraform cover having Cortega provision the infrastructure for you instead.