📹 The future of AI infrastructure: optimize and shard your database with agents.Watch the talk
Navigation

Move your Postgres primary on demand with switchovers

You can now trigger a primary database node switchover on demand for Postgres branches. Use switchovers to verify that your application tolerates a primary change before you depend on it during an unplanned failover, or to move the primary ahead of planned work.

Start a switchover from the cluster actions menu on the branch page, the CLI, or the API. By default an eligible replica is promoted automatically; pass a candidate to pick the replica yourself. On a branch without replicas, the single instance is restarted in place instead.

pscale branch switchover <database> <branch> --org <org> --candidate <replica-name>

From the CLI, pscale branch switchover requires pscale 0.322.0 or later.

Switchover docs · CLI reference · API reference