Quickstart

Kisenon is branchable serverless Postgres. This page walks you from zero to a connected psql session in about two minutes.

Prerequisites

An alpha-access invitation. If you don't have one, see Alpha access.
psql (Postgres 14+ client) on your laptop.

Open kisenon.com and sign in with Google or GitHub. On first sign-in Kisenon creates a personal organization for you — your projects land there until you make a team org.

A project is the unit of isolation — your storage, your branches, your endpoints. Projects belong to your organization. Click New project, give it a name, pick a region. The region selector defaults to Auto (nearest) — see Regions.

A main branch is auto-created. Branches are pointers to copy-on-write storage; creating one costs nothing but a database row.

3. Spawn an endpoint

Endpoints are the wire-protocol Postgres frontends that actually accept client connections. They suspend after 5 minutes idle and wake on first packet.

On the branch page, click + New endpoint. Wait for the green dot.

4. Copy the connection string

Each endpoint card shows its own postgresql://... URI with a unique role and password.

postgresql://<role>:<pwd>@<endpoint_id>.kisenon.com:5432/main?sslmode=require

TLS is required. The host is the endpoint id, not the project id — each endpoint terminates TLS independently.

5. Connect

psql "postgresql://app:•••••@ep_abc123.kisenon.com/main?sslmode=require"

psql (17.0)
main=> select now();
             now
--------------------------------
 2026-05-03 14:22:08.412+00

Done. Run \dt, create a table, do work. Idle five minutes, the endpoint suspends; reconnect and it wakes back up — typically inside the timeout window of any standard Postgres driver.

Prefer the terminal?

Everything above is one keon away. Authenticate via browser OAuth, then create a project from your shell:

keon login
keon projects create --name my-app

--region is optional (defaults to nearest). See the CLI docs for branches and endpoints.

What's next

Concepts — branches, endpoints, scale-to-zero, the copy-on-write model.
Connection strings — the URI format in detail.
FAQ.