Deploy on Netlify
Run Waypoint Server on Netlify with an external Postgres database.
Netlify auto-detects Next.js and handles the build pipeline via the Essential Next.js plugin. You need an external Postgres database — Neon, Supabase, or any managed provider works.
Note
Waypoint Server self-hosting is currently available to enterprise pilot customers. Pilots receive source access to the private repository under the enterprise pilot agreement. Apply for access.
Prerequisites
- A Netlify account
- Source access to
laserowl-io/waypoint-server(granted by LaserOwl on pilot onboarding) - An external Postgres database (Neon, Supabase, etc.)
Step 1 — Fork and connect the repository
Once LaserOwl has granted your GitHub account read access to laserowl-io/waypoint-server, fork it to your own GitHub org. Then create a new Netlify site and connect it to your fork.
Your fork is your stable deploy point — you control when to pull updates from upstream.
Step 2 — Provision Postgres
Create a Postgres database with your preferred provider and copy the connection string.
Neon: Create a project at neon.tech, copy the connection string from the dashboard.
Supabase: Create a project, go to Settings → Database → copy the connection string (use the pooler URL for serverless).
Step 3 — Set environment variables
In your Netlify site's Site configuration → Environment variables:
| Variable | Value |
|---|---|
DATABASE_URL | Your Postgres connection string |
WAYPOINT_JWT_SECRET | Output of openssl rand -hex 32 |
WAYPOINT_RESET_TOKEN | Output of openssl rand -hex 24 |
Step 4 — Deploy
Push to your connected branch. Netlify builds and deploys automatically. Check the function logs — on first boot the server prints an initial admin key.
Step 5 — Connect your team
Follow the Team Setup guide from Step 2 onwards.