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
- PostgreSQL database
- Redis cache
- Backend API server
- Worker background processor
- Admin Frontend on port
4200 - Consumer Frontend on port
4201
4
Verify the installation
Check that all containers are running:Then open:
- Admin frontend → http://localhost:4200
- Consumer frontend → http://localhost:4201
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