Getting started

Create your first managed PostgreSQL database in under a minute.

1. Create an account

Sign up at flokk.dev using GitHub, a passkey, or email and password. No credit card required.

2. Create a database

From the dashboard, click New database. Enter a name, pick your plan (Starter or Pro), and choose a PostgreSQL version. Click Create database.

Your database, read replica, and PgBouncer pooler are provisioned in seconds. A random suffix is appended to your name to avoid collisions (e.g. my-app-db-a7f3e2).

3. Save your credentials

After creation, the dashboard shows your connection details once. Copy and save them:

# Shown once — store these securely
Host:     my-app-db-a7f3e2.db.flokk.dev
Database: my-app-db-a7f3e2
User:     flokk_my-app-db-a7f3e2
Password: flk_xxxxxxxxxxxxxxxxxx

4. Connect

Connect using any PostgreSQL client. SSL is required.

# psql
psql "postgresql://flokk_my-app-db-a7f3e2:PASSWORD@my-app-db-a7f3e2.db.flokk.dev:5432/my-app-db-a7f3e2?sslmode=require"

Your database has two endpoints:

EndpointPortUse
Read-write (primary)5432All queries
Read-only (replica)5433Read-heavy queries, analytics

5. Insert some data

CREATE TABLE users (
  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
  email text NOT NULL UNIQUE,
  created_at timestamptz DEFAULT now()
);

INSERT INTO users (email) VALUES ('hello@example.com');
SELECT * FROM users;

Next steps

No results found.