Requirements
- Docker & Docker Compose v2
- At least 2 GB RAM
- PostgreSQL 15+ (included in Docker Compose)
Docker Compose Deployment
Placet ships with a production-ready docker-compose.yml that includes all required services.
Clone and configure
bash git clone https://github.com/centerbitco/placet.git cd placet cp .env.example .env
Edit .env with your production settings: - Set strong passwords for POSTGRES_PASSWORD,
MINIO_ROOT_PASSWORD - Set JWT_SECRET to a secure random string - Configure INITIAL_USER_EMAIL and
INITIAL_USER_PASSWORD - Set NEXT_PUBLIC_WS_URL and NEXT_PUBLIC_APP_URL to your domain
Start services
bash docker compose up -d
Run migrations
bash docker compose exec backend npx prisma migrate deploy
Services
| Service | Port | Description |
|---|
| Frontend | 3000 | Next.js web application |
| Backend | 3001 | REST API server |
| Postgres | 5432 | PostgreSQL database |
| MinIO | 9000 | S3-compatible object storage |
Reverse Proxy
A Traefik configuration is included in docker-compose.traefik.yml for production deployments with TLS/SSL.
docker compose -f docker-compose.yml -f docker-compose.traefik.yml up -d
Environment Variables
See .env.example in the repository for a complete list of all available environment variables
with descriptions.
Core Settings
| Variable | Description | Default |
|---|
DATABASE_URL | PostgreSQL connection string | — |
JWT_SECRET | Secret for JWT token signing | — |
INITIAL_USER_EMAIL | Initial admin user email | admin@placet.local |
INITIAL_USER_PASSWORD | Initial admin user password | changeme |
NEXT_PUBLIC_WS_URL | WebSocket URL for the frontend | http://localhost:3001 |
NEXT_PUBLIC_APP_URL | Public URL of the frontend | http://localhost:3000 |
File Storage (MinIO/S3)
| Variable | Description | Default |
|---|
MINIO_ENDPOINT | MinIO/S3 endpoint | minio:9000 |
MINIO_ACCESS_KEY | Access key | — |
MINIO_SECRET_KEY | Secret key | — |
MINIO_BUCKET | Bucket name | placet |
