Prerequisites

Before starting, make sure you have these installed:

Option 1: Local Setup (without Docker)

1. Clone the repository

2. Install PHP dependencies

This installs all packages including the 7 monorepo packages in packages/:

3. Configure your environment

Edit .env with your PostgreSQL credentials:

4. Create the database

5. Run migrations and seed

This creates all tables (112+ migrations from database/migrations/ and ~60 from packages) and seeds default data including payment methods and pricing plans.

6. Generate JWT secret

7. Start the development server

The API is now available at http://localhost:8000.

8. Start the queue worker (optional)

9. Start Reverb WebSocket server (optional)

Option 2: Docker Setup

1. Clone and configure

Update .env for Docker:

2. Start all services

This starts three containers:

3. Run migrations inside the container

Useful Makefile commands

Verify your installation

Test with a login request:
You should receive a response with an access_token.

Troubleshooting

Next steps