Installation

SAMSKARA is currently distributed directly to early access teams — book a demo and we’ll get you repository access. Once you have it, bringing up a local instance takes a few minutes.

Requirements

• Docker and Docker Compose
• A copy of the SAMSKARA repository

1. Configure environment variables

Copy the example environment file and fill in the values:

cp .env.example .env

At minimum, set:

• SECRET_KEY — generate with python -c "import secrets; print(secrets.token_hex(32))"
• SECRET_ENCRYPTION_KEY — generation helper is in .env.example
• POSTGRES_PASSWORD / REDIS_PASSWORD — strong values for your local database and cache

Leave SMTP_HOST empty to skip email notifications entirely — everything else works without it.

2. Start the stack

docker compose up -d

This brings up the complete SAMSKARA stack — database, cache, backend services, AI, and the web interface — all as containers you own and control.

3. Open SAMSKARA

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000

Create your first organization and user from the sign-up screen, then continue to First Notebook in 5 Minutes.

Production deployment

docker-compose.prod.yml adds Caddy for automatic HTTPS against the DOMAIN you configure in .env. Set APP_ENV=production — SAMSKARA will refuse to start if SECRET_KEY or SECRET_ENCRYPTION_KEY are missing or left at their insecure defaults.