delimiter
/
Dashboard
SELF-HOSTING / SETUP

Self-Hosting Setup

Delimiter is MIT licensed. You can self-host the entire stack.

Prerequisites#

  • Node.js 18+
  • pnpm 9+
  • PostgreSQL database (Neon free tier works great)

Clone and install#

git clone https://github.com/delimiterapp/delimiter.git
cd delimiter
pnpm install

Configure environment#

cp apps/web/.env.example apps/web/.env

Required environment variables:

DATABASE_URL="postgresql://user:password@host:5432/delimiter"
WEBAUTHN_RP_NAME="Delimiter"
WEBAUTHN_RP_ID="localhost"
WEBAUTHN_ORIGIN="http://localhost:3000"

Set up the database#

pnpm --filter web db:push

Start the server#

pnpm dev

The web app starts at http://localhost:3000.

Point your SDK to your instance#

delimiter.init('dlm_your_project_key', {
  endpoint: 'https://your-delimiter-instance.com/api/report'
})

Deployment#

The web app deploys to Vercel with zero configuration. Use Neon for the PostgreSQL database in production. Set environment variables in your deployment platform.