Self-host

Your workspace, on infrastructure you control.

The complete PlanGlade core stays public, provider-neutral, and usable without a hosted PlanGlade account.

Before you begin

Self-hosting is a technical setup.

PlanGlade is an early preview. Use unique secrets, terminate TLS, keep tested backups, and review the security guide before exposing it to the internet.

  1. 01

    Clone and configure

    Generate a local release configuration with unique secrets. Do not commit the resulting environment file.

  2. 02

    Build and start

    Use Docker Compose to build the frontend and backend, then start the single-origin application.

  3. 03

    Create the first owner

    Open the setup route, use the one-time setup token, and create the first workspace owner.

  4. 04

    Protect and back up

    Back up both the SQLite data and attachment volume, then rehearse a restore before relying on the installation.

Local release path

One origin, two runtime responsibilities.

The frontend serves the product interface. The API-only backend owns authentication, SQLite, migrations, and attachments.

PowerShell or shell
git clone https://github.com/kalelooz/planglade
cd planglade
npm run setup:local
docker compose -f compose.yml config
docker compose -f compose.yml build
docker compose -f compose.yml up -d

What stays yours

A public core without a provider lock.

The documented self-host path uses standard local components. Optional OAuth and email delivery do not replace the local baseline.

Identity
NextAuth with local email and password enabled by default.
Data
SQLite with checked-in migrations and documented upgrade procedures.
Files
Local attachment storage on a dedicated Docker volume.
Recovery
Backup, restore, and production migration guides live in the public repository.

Use the maintained guide

Read the current prerequisites and security notes before installing.

The repository documentation is the source of truth for setup commands, environment variables, upgrades, and backups.