Managed Databases
Provision and manage Postgres, Redis, ClickHouse, and Qdrant clusters from the Customer Portal.
Databases provisions managed data stores in your workspace — Postgres, Valkey-compatible Redis, ClickHouse, and Qdrant — without leaving the portal. Credentials are stored in Secrets; the API never returns raw passwords.
Who can access
| Action | Typical permission |
|---|---|
| List / view connection info | read |
| Create / scale / backup / restore | write |
| Delete cluster | delete |
Prerequisites
- Workspace selected in the top navigation picker
- Workspace within its managed-database quota (Quotas)
Create a database
Open Databases
In the sidebar under Data, click Databases.
Click Create
Choose an engine (Postgres, Redis, ClickHouse, or Qdrant), a name, and a tier (small or medium).
Wait for provisioning
Creation is asynchronous. The list and detail pages show status until the cluster is ready.
Connection info
Open a database from the list to see host and port. Username, password, and API keys are revealed from workspace Secrets (audited), not returned inline by the Control Plane.
Scale and backups
| Capability | Notes |
|---|---|
| Scale | Change tier on the detail page when the cluster is ready |
| On-demand backup | Supported for Postgres, Redis, and ClickHouse |
| Backup schedule | Configure retention on engines that support backups |
| Restore | Restores create a new cluster from a backup |
| PITR | Postgres point-in-time recovery depends on infra enablement |
Qdrant backup/restore is not available yet.
Delete a database
From the detail page, delete and confirm. Deletion is irreversible; recreate from a backup if you need the data.
Troubleshooting
| Problem | Likely cause | What to do |
|---|---|---|
| Create stuck pending | Provisioning saga in progress | Wait and refresh; check Process Log |
| Cannot create | Quota exceeded | Check Quotas or free an unused cluster |
| No password shown | Credentials in Secrets only | Reveal the linked secret key on the detail page |
| 403 on create | Missing write | Check Members & Roles |
Related API
GET/POST /v1/workspaces/{id}/managed-databasesGET/PATCH/DELETE /v1/workspaces/{id}/managed-databases/{db_id}POST …/scale,…/backups,…/restore,…/rotate-credentials
Related
- Secrets — where credentials live
- Quotas — per-workspace limits
- Environment Promotion — promote config, not database data