Quick Start

Get JITSudo running locally with Docker Compose for evaluation and development. The compose environment includes PostgreSQL, a local OIDC provider (Dex), the API server, and the background worker.

Prerequisites

• Docker and Docker Compose
• Git

Steps

Clone the repository and start all services:

git clone https://github.com/jitsudo/jitsudo.git
cd jitsudo
make compose-up

This starts five services:

Service	Description	Port
postgres	PostgreSQL 17 database	5432
dex	Local OIDC provider for development	5556
migrate	Runs database schema migrations (exits after completion)	—
server	API server	8080
worker	Background job processor	—

The migrate service runs automatically before the server and worker start.

Start the Frontend

In a separate terminal:

make dev-web

The web UI is available at http://localhost:5173, proxying API requests to the server on port 8080.

Verify It’s Running

Check the health endpoint:

curl http://localhost:8080/healthz

Stop Services

make compose-down

What’s Next

• Configuration — configure OIDC, AWS, and policies
• Cedar Policies — define access control rules