Installation

1. Clone the repository

git clone https://github.com/Aicser-Platform/aicser.git
cd aicser

2. Configure environment

cp server/env.example deploy/.env

Open deploy/.env and set the required values:

# Edition
AISER_EDITION=enterprise
LICENSE_KEY=your-license-key-from-aicser-com

# Security — generate unique values for every deployment
SECRET_KEY=        # see commands below
ENCRYPTION_KEY=    # see commands below

# Database
POSTGRES_USER=aiser
POSTGRES_PASSWORD=change-this-password
POSTGRES_DB=aiser

# AI (required for natural language features)
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_API_VERSION=2024-02-15-preview
AZURE_OPENAI_DEPLOYMENT_NAME=your-deployment-name

Generate the required secrets:

# SECRET_KEY
openssl rand -hex 32

# ENCRYPTION_KEY
python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

See Environment Variables for the full reference.

3. Deploy

cd deploy
make ee

This builds the server and client images and starts all five services. First-run image builds take 5–10 minutes.

4. Verify

docker compose -f docker-compose.ee.yml ps

All services should show Up (healthy). If a service is restarting, inspect its logs:

make ee-logs

Health endpoints:

curl http://localhost:8001/health    # Server
curl http://localhost:8123/ping     # ClickHouse

Open http://localhost:3001 in your browser.

5. Create the first account

Next steps

SSL & Reverse Proxy — serve over HTTPS with a domain
Storage Configuration — configure persistent file storage
Authentication — configure SSO

1. Clone the repository​

2. Configure environment​

3. Deploy​

4. Verify​

5. Create the first account​

Next steps​