Democratic AI for the
Public Sector

# Clone the repository and enter the deployment folder
git clone https://github.com/eneo-ai/eneo.git
cd eneo/docs/deployment/
 
# Copy environment templates
cp env_backend.template env_backend.env
cp env_frontend.template env_frontend.env
cp env_db.template env_db.env
 
# Create the external network Traefik uses
docker network create proxy_tier
 
# Generate the secrets the templates ship empty
echo "JWT_SECRET=$(openssl rand -hex 32)"          # env_backend.env
echo "URL_SIGNING_KEY=$(openssl rand -hex 32)"     # env_backend.env
echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" # env_backend.env AND env_db.env
docker compose run --rm --no-deps backend python -m eneo.cli.generate_encryption_key  # ENCRYPTION_KEY in env_backend.env
 
# Paste the values into the env files, set PUBLIC_ORIGIN and the domain URLs,
# and replace your-domain.com / your-email@domain.com in docker-compose.yml
 
# Start all services
docker compose up -d

# Clone the repository
git clone https://github.com/eneo-ai/eneo.git
cd eneo
 
# Open in VS Code
code .
# Click "Reopen in Container" when prompted
 
# Inside the container (nothing starts automatically)
cd backend && uv run python init_db.py   # first run: migrations + default user
cd backend && uv run start               # terminal 1: API on :8123
cd frontend && bun run dev               # terminal 2: web app on :3000
cd backend && uv run worker              # terminal 3: uploads and crawls