This guide uses Docker to run Agenta, an open-source LLMOps platform for prompt management, evaluation, and observability.
For Docker installation, see Docker.
Clone the Agenta repository and change into the project directory.
git clone --depth 1 https://github.com/Agenta-AI/agenta && cd agenta
Copy the example environment file to create your configuration.
cp hosting/docker-compose/oss/env.oss.gh.example hosting/docker-compose/oss/.env.oss.gh
Optional: Edit the environment file to customize settings like TRAEFIK_PORT for a custom port.
Launch Agenta with the web UI and Traefik reverse proxy profiles.
docker compose -f hosting/docker-compose/oss/docker-compose.gh.yml --env-file hosting/docker-compose/oss/.env.oss.gh --profile with-web --profile with-traefik up -d
Open your browser and navigate to:
TRAEFIK_PORT)Agenta uses multiple container images hosted on GitHub Container Registry:
| Image | Full Name |
|---|---|
| API Service | ghcr.io/agenta-ai/agenta-api |
| Web UI | ghcr.io/agenta-ai/agenta-web |
| Services | ghcr.io/agenta-ai/agenta-services |
To run Agenta on a custom port, edit hosting/docker-compose/oss/.env.oss.gh:
TRAEFIK_PORT=90
AGENTA_SERVICES_URL=http://localhost:90/services
AGENTA_API_URL=http://localhost:90/api
AGENTA_WEB_URL=http://localhost:90
Then restart the stack:
docker compose -f hosting/docker-compose/oss/docker-compose.gh.yml --env-file hosting/docker-compose/oss/.env.oss.gh --profile with-web --profile with-traefik up -d
To upgrade to the latest version:
# Pull latest images
docker compose -f hosting/docker-compose/oss/docker-compose.gh.yml --env-file hosting/docker-compose/oss/.env.oss.gh --profile with-web --profile with-traefik up -d --pull always
# Run database migrations
docker exec -e PYTHONPATH=/app -w /app/oss/databases/postgres/migrations/core agenta-oss-gh-api-1 alembic -c alembic.ini upgrade head
TRAEFIK_PORT environment variableAny questions?
Feel free to contact us. Find all contact information on our contact page.