Quickstart
Spin up your first Kisenon project, branch, and endpoint in five steps.
Kisenon is branchable serverless Postgres you can point an AI agent at
safely — see Agent-Safe Change Control. This page walks
you from zero to a connected psql session in about two minutes.
Prerequisites
- A Kisenon account — sign in with Google or GitHub at kisenon.com.
psql(Postgres 14+ client) on your laptop.
1. Sign in
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.
2. Create a project
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>.<region>.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:•••••@<endpoint-id>.<region>.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.
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.