Skip to main content

Setup builder

Fills in the blanks of the self-host .env. Everything runs in your browser; nothing you type leaves this page. Secrets are pre-generated for you, and each lives on exactly one line: the stack derives the database connection strings, so changing the password later is a one-line edit.

1 · RequiredJust the name, no https:// (pasting one strips it).
Postgres password and JWT secret are generated too (see the preview); those are replaceable. The encryption key is not: lose it and stored integration credentials are gone.
2 · HTTPS

Recommended. No proxy in the stack; the tailnet gives a trusted cert with nothing exposed. Set the address above to your box's ts.net name, then run tailscale serve --bg 8088 (or funnel) on the host. See Install.

3 · Email (optional)

Password login works; invites become copy-the-link. Magic-link sign-in needs a sender.

4 · Privacy
5 · Advanced
.env (you fill this in)
Still need the address. Confirm the key backup in section 1. Copy and Download unlock once these are done.
# Cobblr self-host — generated by the setup builder.

# ── 1. REQUIRED ─────────────────────────────
COBBLR_SITE_ADDRESS=
SUPERADMIN_EMAILS=
POSTGRES_PASSWORD=7nejAeMkhYbUEtRJhFeG9xFg
JWT_SECRET=244caf8c29d21a1270794f7fada3aad916520f48d7cd3e26add29232295c1374
# ⚠ back the next line up — unrecoverable:
TENANT_CREDS_ENCRYPTION_KEY=2adb4ea280c801b53e339f94d88d0266
# set false after your account exists, especially if exposing your instance to the public:
PUBLIC_SIGNUP_ENABLED=true

# ── 2. HTTPS ────────────────────────────────
# no caddy. The tailnet terminates HTTPS. Run tailscale serve
# (or funnel) on the host; see the install guide.
COMPOSE_PROFILES=
WEB_PORT=8088

# ── 3. EMAIL ────────────────────────────────
# none configured — password login works;
# invites are copy-the-link.

# ── 4. PRIVACY ──────────────────────────────
# COBBLR_AI_ENABLED=false
# COBBLR_SCAN_EXTERNAL_LOOKUPS=false

# ── 5. ADVANCED ─────────────────────────────
# COBBLR_VERSION=latest
# DB connection strings derive from POSTGRES_PASSWORD in the stack;
# set DATABASE_URL / SUPERUSER_DATABASE_URL only for an external Postgres.
docker-compose.yml (same for everyone)Download
# loading docker-compose.yml…
Drop both files in a folder together, thendocker compose up -d. See Install for the full walkthrough.