Local Development Setup¶

This guide sets up a complete La Suite Meet development environment on your machine.

Prerequisites¶

Docker Engine 20.10+
Docker Compose v2+
Git
Make
LiveKit CLI

Install LiveKit CLI¶

curl -sSL https://get.livekit.io/cli | bash
lk --version

Clone the repository¶

git clone https://github.com/suitenumerique/meet.git
cd meet

Option 1: Docker Compose (recommended)¶

The Docker Compose stack starts all services with a single command.

Bootstrap (first time only)¶

make bootstrap FLUSH_ARGS='--no-input'

This builds the backend image, installs dependencies, runs migrations, creates a default user (meet / meet), and compiles translations.

Start the stack¶

make run

Service	URL
Frontend	http://localhost:3000
Backend API	http://localhost:8071
Keycloak (OIDC)	http://localhost:8083
LiveKit	ws://localhost:7880
Garage	http://localhost:3900 (admin: :3901)
Mailcatcher	http://localhost:1081

Default credentials: Meet meet/meet, Keycloak admin admin/admin, Garage meet-access-key/password.

Stop¶

make stop

Add demo data¶

make demo

Frontend development (hot reload)¶

Run the backend in the background and start the frontend with HMR:

make run-backend
make frontend-development-install
make run-frontend-development

Equivalent direct npm commands:

cd src/frontend
npm install
npm run dev

The frontend dev server runs at http://localhost:5173.

Backend development¶

# Django shell
docker compose exec app-dev python manage.py shell

# Create superuser
docker compose exec app-dev python manage.py createsuperuser

# Run backend tests
make test-back

# Lint Python
make lint-back

Admin panel: http://localhost:8071/admin/

Option 2: Kubernetes with Tilt¶

For a production-like local environment:

make build-k8s-cluster
make start-tilt-keycloak
# Monitor at http://localhost:10350/
# App at https://meet.127.0.0.1.nip.io/

View all Make commands¶

make help