This is the recommended way to run Ringee for production use. It handles all services (PostgreSQL, Redis, Frontend, Backend, Worker) in a single configuration.
Prerequisites
- Docker installed
- Docker Compose installed
- API keys for required services (see Configuration Reference)
Installation
1
Clone the repository
2
Create your environment file
.env in your editor and fill in your API keys. At minimum, you need:NEXT_PUBLIC_CLERK_PUBLISHABLE_KEYandCLERK_SECRET_KEY— Get from ClerkTELNYX_API_KEYandTELNYX_CONNECTION_ID— Get from TelnyxSTRIPE_SECRET_KEY— Get from Stripe
3
Start all services
- Backend API server on port
3000 - Orchestrator — the Temporal worker for background jobs
- Frontend on port
4200
docker-compose up -d.4
Verify the installation
Check that all containers are running:Then open:
- Frontend → http://localhost:4200
- Backend API → http://localhost:3000/api
- Temporal UI → http://localhost:8080
When using
docker-compose.app.yml, the values for DATABASE_URL, REDIS_HOST, REDIS_PORT, and REDIS_URL are automatically overridden to use Docker internal hostnames. You don’t need to set these manually.Useful commands
Next steps
Configuration
Fine-tune your environment variables
Docker Config
Learn about Docker-specific configuration options