# Production Deployment Guide {#production-deployment-guide}


Deploy Ever Gauzy to production environments with Docker, Kubernetes, or cloud platforms.


## Prerequisites {#prerequisites}


- Node.js 20+ or Docker
- PostgreSQL 14+ (recommended for production)
- Redis 6+ (for caching and job queues)
- 2GB+ RAM for API server
- Reverse proxy (Nginx, Caddy, or cloud LB)


## Deployment Options {#deployment-options}



### Docker Compose (Recommended) {#docker-compose-recommended}


The fastest way to deploy all services:

```yaml
version: "3.8"
services:
  api:
    image: ghcr.io/ever-co/gauzy-api:latest
    environment:
      - DB_TYPE=postgres
      - DB_HOST=db
      - DB_PORT=5432
      - DB_NAME=gauzy
      - DB_USER=postgres
      - DB_PASS=your-secure-password
      - REDIS_HOST=redis
      - REDIS_PORT=6379
      - JWT_SECRET=your-jwt-secret
    ports:
      - "3000:3000"
    depends_on:
      - db
      - redis

  webapp:
    image: ghcr.io/ever-co/gauzy-webapp:latest
    ports:
      - "4200:4200"
    environment:
      - API_BASE_URL=http://api:3000

  db:
    image: postgres:16
    environment:
      - POSTGRES_DB=gauzy
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=your-secure-password
    volumes:
      - pgdata:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    volumes:
      - redisdata:/data

volumes:
  pgdata:
  redisdata:
```


### Kubernetes {#kubernetes}


See the [Kubernetes Deployment](https://sourcey-gauzy.pages.dev/deployment/kubernetes/index.md) guide.


### Cloud Platforms {#cloud-platforms}


- [DigitalOcean App Platform](https://sourcey-gauzy.pages.dev/deployment/cloud/digitalocean-deployment/index.md)
- [Render Deployment](https://sourcey-gauzy.pages.dev/deployment/cloud/render-deployment/index.md)
- [Fly.io Deployment](https://sourcey-gauzy.pages.dev/deployment/cloud/flyio-deployment/index.md)


## Post-Deployment Checklist {#post-deployment-checklist}


- [ ] Set strong `JWT_SECRET` and `JWT_REFRESH_SECRET`
- [ ] Configure database backups
- [ ] Set up monitoring and alerting
- [ ] Configure SMTP for email delivery
- [ ] Set up SSL/TLS certificates
- [ ] Configure CORS allowed origins
- [ ] Set `NODE_ENV=production`
- [ ] Enable rate limiting
- [ ] Configure file storage provider


## Related Pages {#related-pages}


- [Environment Variables Reference](https://sourcey-gauzy.pages.dev/devops/environment-variables/index.md) — all config options
- [Monitoring & Observability](https://sourcey-gauzy.pages.dev/devops/monitoring/index.md) — production monitoring
- [Database Backup & Recovery](https://sourcey-gauzy.pages.dev/devops/database-backup/index.md) — backup strategies