Project Services
Project services let you provision managed database and infrastructure services for your projects. Services run as Docker containers alongside your preview containers.
Available Services#
PostgreSQL (Available)#
Managed PostgreSQL databases with:
- Versions: 17 (default), 16, 15
- Size tiers:
| Tier | Memory | CPU | Storage |
|---|---|---|---|
| Dev | 256 MB | 0.5 | 1 GB |
| Standard | 512 MB | 1.0 | 5 GB |
| Performance | 1 GB | 2.0 | 20 GB |
Redis (Available)#
Managed Redis instances for caching and sessions:
- Versions: 7 (default), 6
- Size tiers:
| Tier | Memory | CPU | Storage |
|---|---|---|---|
| Dev | 128 MB | 0.5 | 512 MB |
| Standard | 256 MB | 1.0 | 2 GB |
| Performance | 512 MB | 2.0 | 10 GB |
Coming Soon#
- MySQL
- MongoDB
- Qdrant (vector database)
- MinIO (S3-compatible storage)
- Mailpit (email testing)
Provisioning a Service#
From Project Settings > Services:
- Choose a service type (e.g., PostgreSQL)
- Select a size tier and version
- Click Provision — the service starts provisioning asynchronously
The service goes through these states:
Pending → Provisioning → Running → Stopped
→ Error
→ Destroying → Destroyed
Credentials#
Each service generates credentials automatically. Credentials are encrypted at rest and can be viewed in masked or revealed mode.
PostgreSQL Credentials#
| Key | Example |
|---|---|
DATABASE_URL | postgresql://user:pass@host:5432/db |
PGHOST | Container hostname |
PGPORT | 5432 |
PGUSER | Auto-generated username |
PGPASSWORD | Securely generated password |
PGDATABASE | Auto-generated database name |
Redis Credentials#
| Key | Example |
|---|---|
REDIS_URL | redis://:pass@host:6379 |
REDIS_HOST | Container hostname |
REDIS_PORT | 6379 |
REDIS_PASSWORD | Securely generated password |
Managing Services#
| Action | Description |
|---|---|
| Start | Start a stopped service |
| Stop | Stop a running service (data preserved) |
| Restart | Stop and start a service |
| Destroy | Permanently remove the service, container, and volume |
Permission required: project:settings for start/stop/restart, project:delete for destroy.
Health Checks#
Services include automatic health checks. For PostgreSQL, the system uses pg_isready to verify the database is accepting connections before marking the service as running.
Service Catalog#
The service catalog shows all available and coming-soon services. Each catalog entry includes the service type, description, available versions, size tiers, and the environment variable keys that will be generated.