Installation

Deploy Lucaro using Docker, Kubernetes, or our managed cloud service.

Deployment Options

Lucaro Cloud

Get started instantly with our fully managed cloud service. No installation required.

Automatic updates and maintenance
Built-in high availability
Pursuing SOC 2 Type II certification
99.9% uptime SLA

Self-Hosted

Deploy Lucaro in your own infrastructure for full control over your data.

Docker and Kubernetes support
Data never leaves your network
Custom security configurations
Air-gapped deployments available

System Requirements

Component	Minimum	Recommended
CPU	2 cores	4+ cores
Memory	4 GB RAM	8+ GB RAM
Storage	20 GB SSD	50+ GB SSD
Docker	20.10+	Latest stable
PostgreSQL	13+	15+

Docker Installation

The fastest way to deploy Lucaro self-hosted is using Docker Compose.

1. Clone the Repository

git clone https://github.com/lucaro-dev/lucaro.git
cd lucaro

2. Configure Environment

Copy the example environment file and configure your settings:

cp .env.example .env

# Edit .env with your configuration
# Required settings:
DATABASE_URL=postgresql://lucaro:password@postgres:5432/lucaro
SECRET_KEY=your-secret-key-here
AUTH0_DOMAIN=your-tenant.auth0.com
AUTH0_CLIENT_ID=your-client-id
AUTH0_CLIENT_SECRET=your-client-secret

3. Start the Services

docker compose up -d

# Check status
docker compose ps

# View logs
docker compose logs -f

4. Initialize the Database

# Run database migrations
docker compose exec backend alembic upgrade head

# Create initial admin user (optional)
docker compose exec backend python -m lucaro.cli create-admin

Success! Lucaro is now running at http://localhost:3000

Kubernetes Installation

For production deployments, we recommend using Helm to install Lucaro on Kubernetes.

Add the Helm Repository

helm repo add lucaro https://charts.lucaro.dev
helm repo update

Install with Custom Values

# Create values file
cat > values.yaml << EOF
replicaCount: 2
image:
  tag: latest
ingress:
  enabled: true
  hosts:
    - host: lucaro.example.com
      paths:
        - path: /
          pathType: Prefix
postgresql:
  enabled: true
  auth:
    password: secure-password
EOF

# Install
helm install lucaro lucaro/lucaro -f values.yaml

Verify Installation

After installation, verify that all components are running correctly:

# Check API health
curl http://localhost:8000/health

# Expected response:
{
  "status": "healthy",
  "database": "connected",
  "version": "1.0.0"
}