Docs/Engines/Neon

Neon

Neon is serverless PostgreSQL, wire-compatible and behaving identically here. Setting type: neon records the engine you actually run in history and in reports.

type
neon
Driver
psycopg
DDL
Transactional
Config class
PostgreSQL

Install

pip install "dblift[neon]"

Connection URL

postgresql+psycopg://user:password@ep-example.eu-central-1.aws.neon.tech/app

A plain postgresql:// URL works. Keep sslmode in the URL or in ssl_mode, as your project requires.

dblift.yaml

database:
  type: neon
  url: "postgresql+psycopg://db.internal:5432/app"
  schema: "public"
  ssl_mode: "require"
migrations:
  directory: "./migrations"

Engine settings

KeyDefaultEffect
schemapublicSets the connection's search_path, so unqualified objects land here.
ssl_mode—Passed through as PostgreSQL's sslmode: require, verify-ca, verify-full.
connection_timeout30Seconds to wait for a connection, sent as connect_timeout.
extra_params{}Any other libpq parameter, appended to the connection URL.

Behaviour notes

No declared differences from PostgreSQL.

Capabilities come straight from the PostgreSQL provider.

The PostgreSQL page is the reference.

Read it for DDL, index and drop behaviour.