Provision a PostgreSQL database

5 min readUpdated August 2026

Managed Postgres is an add-on on the phase, not a container you run from your repo. Add it from the canvas, attach it to the app, then run migrations with your usual start command or a one-off from the dashboard — not a StackBlaze CLI.

Step by step

01

Add Postgres from the canvas

On the phase canvas, click + Service → Databases and pick PostgreSQL (kind Cluster). The default instance name is often postgresql. Stage it, then Commit the change.

02

Attach it to the app

Wire the add-on to your app on the canvas (or the app Add-ons tab). StackBlaze injects connection values such as PGHOST, PGPORT, PGUSER, PGDATABASE, and PGPASSWORD. DATABASE_URL is set when the password is available to the injector.

03

Run migrations from the app

Put migrate in the start command (for example prisma migrate deploy && node dist/index.js) or run it in a scheduled job. There is no stackblaze CLI migrate command on this control plane.

Backups

Point-in-time restore lives on the add-on Backups tab. Restore creates a new instance; it does not overwrite the live one.