This guide walks through a self-hosted installation of Agenta, an open-source LLMOps platform for prompt management, evaluation, and observability.
For Docker installation, see Docker.
Use Git to download the source code. Using --depth 1 for a shallow clone reduces download size.
git clone --depth 1 https://github.com/Agenta-AI/agenta && cd agenta
Create a local .env file from the example template.
cp hosting/docker-compose/oss/env.oss.gh.example hosting/docker-compose/oss/.env.oss.gh
Use Docker Compose to build and start the Agenta stack with web UI and Traefik reverse proxy.
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 in .env.oss.gh)Prefer automation? See Agenta Ansible Setup for an example playbook.
Prefer containers? See Agenta Docker Setup.
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
Any questions?
Feel free to contact us. Find all contact information on our contact page.