Docker

Run Authorizer using Docker with the v2 CLI-only configuration model.

---

Quick Start

docker run -p 8080:8080 lakhansamani/authorizer:latest \
  --database-type=sqlite \
  --database-url=test.db \
  --jwt-type=HS256 \
  --jwt-secret=test \
  --admin-secret=admin \
  --client-id=123456 \
  --client-secret=secret

Then open http://localhost:8080/app for the built-in login UI.

---

Using with PostgreSQL

docker run -p 8080:8080 lakhansamani/authorizer:latest \
  --database-type=postgres \
  --database-url="postgres://user:pass@host:5432/authorizer" \
  --jwt-type=HS256 \
  --jwt-secret=your-jwt-secret \
  --admin-secret=your-admin-secret \
  --client-id=123456 \
  --client-secret=secret

---

Docker Compose

Create a docker-compose.yml:

version: "3.8"
services:
  authorizer:
    image: lakhansamani/authorizer:latest
    ports:
      - "8080:8080"
    command:
      - "--database-type=sqlite"
      - "--database-url=/data/test.db"
      - "--jwt-type=HS256"
      - "--jwt-secret=test"
      - "--admin-secret=admin"
      - "--client-id=123456"
      - "--client-secret=secret"
    volumes:
      - authorizer_data:/data

volumes:
  authorizer_data:

Start with:

docker compose up -d

---

Docker Compose with PostgreSQL and Redis

version: "3.8"
services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_USER: authorizer
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: authorizer
    volumes:
      - pg_data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

  authorizer:
    image: lakhansamani/authorizer:latest
    ports:
      - "8080:8080"
    depends_on:
      - postgres
      - redis
    command:
      - "--database-type=postgres"
      - "--database-url=postgres://authorizer:secret@postgres:5432/authorizer"
      - "--redis-url=redis://redis:6379"
      - "--jwt-type=HS256"
      - "--jwt-secret=test"
      - "--admin-secret=admin"
      - "--client-id=123456"
      - "--client-secret=secret"
      - "--env=production"

volumes:
  pg_data:

---

Using Environment Variables with v2

The v2 server does not read from .env files or OS env vars directly. To use env vars in your deployment, map them into CLI flags:

docker run -p 8080:8080 \
  -e DATABASE_TYPE=sqlite \
  -e DATABASE_URL=test.db \
  -e JWT_SECRET=test \
  -e ADMIN_SECRET=admin \
  -e CLIENT_ID=123456 \
  -e CLIENT_SECRET=secret \
  lakhansamani/authorizer:latest \
    --database-type="$DATABASE_TYPE" \
    --database-url="$DATABASE_URL" \
    --jwt-type=HS256 \
    --jwt-secret="$JWT_SECRET" \
    --admin-secret="$ADMIN_SECRET" \
    --client-id="$CLIENT_ID" \
    --client-secret="$CLIENT_SECRET"

---

Required Variables

Flag	Description	Example
--database-type	Database type	sqlite, postgres, mysql
--database-url	Database connection string	test.db
--jwt-type	JWT signing algorithm	HS256, RS256
--jwt-secret	JWT signing secret (for HS256)	test
--admin-secret	Admin secret for admin operations	admin
--client-id	Client identifier (required)	123456
--client-secret	Client secret (required)	secret

For all available flags, see Server Configuration.