Local Deployment
Run Qlarr locally using Docker Compose. This sets up the full stack -- frontend, backend, PostgreSQL, and a mail testing server -- on your machine.
Prerequisites
- Docker and Docker Compose installed
- Git installed
Setup
Clone the frontend repository and navigate to the deployment directory:
git clone https://github.com/qlarr-surveys/frontend.git && cd frontend/deploy
Start all services:
docker compose -f docker-compose.local.yml up -d
Once the containers are running, open http://localhost:3000 in your browser.
Services
| Service | URL | Description |
|---|---|---|
| Frontend | http://localhost:3000 | Qlarr UI served by Caddy |
| Backend API | http://localhost:8080 | Spring Boot API |
| Mailhog | http://localhost:8025 | Email testing UI (captures all outgoing emails) |
| PostgreSQL | localhost:5432 | Database |
Default Credentials
Log in with:
- Email:
admin@admin.admin - Password:
admin
Stop
docker compose -f docker-compose.local.yml down
Full Reset
To remove all data (database, uploaded files) and start fresh:
docker compose -f docker-compose.local.yml down -v
docker compose -f docker-compose.local.yml up -d