Self-Hosting Elixium (Beta - Q1 2026)
Beta Access Required
Self-hosted deployment is currently in beta. Contact [email protected] to request access to the deployment package and Docker registry credentials.
Run the entire Elixium stack on your own infrastructure. Perfect for air-gapped environments, compliance requirements, or total data sovereignty.
Prerequisites
- Docker 20.10+ and Docker Compose 2.0+
- 4 CPU cores and 8GB RAM minimum
- 20GB disk space for images and data
- Enterprise license (contact sales for beta access)
Quick Start
# Step 1: Authenticate to Docker registry
$ docker login ghcr.io
Username: [provided by sales team]
Password: [provided by sales team]
# Step 2: Extract deployment package
$ tar -xzf elixium-self-hosted.tar.gz
$ cd elixium-self-hosted
# Step 3: Configure environment
$ cp .env.example .env
$ nano .env # Set passwords (look for CHANGE_ME)
# Step 4: Initialize and start
$ ./scripts/init.sh
✓ Keycloak realm imported
✓ MinIO buckets created
✓ Database migrations complete
✓ Ollama model pulled
# Step 5: Access Elixium
$ open http://localhost:3000
🔐 Default Credentials
- Elixium: admin / admin (change on first login)
- Keycloak Admin: admin / [your KEYCLOAK_ADMIN_PASSWORD]
- MinIO Console: [your MINIO_ROOT_USER] / [your MINIO_ROOT_PASSWORD]
Included Services
| Service | Port | Purpose |
|---|---|---|
| Elixium App | 3000 | Main application |
| Keycloak | 8080 | Authentication & SSO |
| MinIO | 9000 / 9001 | Object storage (API / Console) |
| PostgreSQL | 5432 | Database |
| Ollama | 11434 | Local AI inference |
Configuration
The deployment uses a single ELIXIUM_MODE flag to control all services:
# Self-hosted mode (uses Keycloak, Postgres, MinIO, Ollama) ELIXIUM_MODE=local # Required: Set secure passwords POSTGRES_PASSWORD=CHANGE_ME KEYCLOAK_ADMIN_PASSWORD=CHANGE_ME MINIO_ROOT_PASSWORD=CHANGE_ME # Optional: Customize service endpoints KEYCLOAK_URL=http://localhost:8080 MINIO_ENDPOINT=http://localhost:9000
Bring Your Own Infrastructure
You can point Elixium to your existing services instead of using the bundled stack:
# Use your own Keycloak NEXT_PUBLIC_KEYCLOAK_URL=https://sso.yourcompany.com NEXT_PUBLIC_KEYCLOAK_REALM=your-realm # Use your own PostgreSQL DATABASE_URL=postgresql://user:[email protected]/elixium # Use your own S3-compatible storage NEXT_PUBLIC_MINIO_ENDPOINT=s3.yourcompany.com NEXT_PUBLIC_MINIO_BUCKET=elixium-uploads
Troubleshooting
Check Service Health
docker compose ps docker compose logs -f app
Run E2E Tests
./scripts/test-e2e.sh
Reset Everything
docker compose down -v # WARNING: Deletes all data ./scripts/init.sh
Enterprise Support
Need help with deployment, custom integrations, or have questions? Our enterprise support team is here to help.