Quickstart

This page summarizes the fastest local setup. For full detail see Local development.

Prerequisites

• Java 21
• Docker + Compose v2
• pnpm 12 (optional — for Next.js frontends)

1. Start infrastructure

cd Directwerk
cp .env.example .env
# Set SPRING_DATASOURCE_PASSWORD, DIRECTWERK_PLATFORM_CLIENT_SECRET, DIRECTWERK_TENANT_CLIENT_SECRET
docker compose up -d

2. Run the API

./gradlew :directwerk-app:bootRun

URL	Purpose
http://localhost:8080/actuator/health	Health
http://localhost:8080/swagger-ui.html	OpenAPI UI
http://127.0.0.1:8025	Mailpit inbox

3. Seeded tenants

Local profile seeds alpha tenants:

• alpha-a.localhost → tenant alpha-show-a
• alpha-b.localhost → tenant alpha-show-b

Add to /etc/hosts if needed:

127.0.0.1 alpha-a.localhost alpha-b.localhost

Default password: value of DIRECTWERK_DEV_SEED_PASSWORD in .env.

4. Optional frontends

From the repo root:

pnpm install
cd directwerk-studio && pnpm dev   # :3003
cd directwerk-web && pnpm dev      # :3004

Next

• Environment variables
• Subscriptions & entitlements — how paid content works
• API integration