Quickstart
Spin up your first Kisenon project, branch, and endpoint in five steps.
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.
1. Sign in
Open kisenon.com and sign in with Google or GitHub.
2. Create a project
A project is the unit of isolation — your tenant, your billing, your branches. Click New project, give it a name, pick a region.
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=requireTLS 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+00Done. 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.
What's next
- Concepts — branches, endpoints, scale-to-zero, the copy-on-write model.
- Connection strings — the URI format in detail.
- FAQ.