Deploy on Railway
Run Waypoint Server on Railway with a native Postgres add-on.
Railway is the quickest cloud path for most teams — it provides a native Postgres add-on and Docker image deploys with minimal configuration.
Note
Waypoint Server self-hosting is currently available to enterprise pilot customers. LaserOwl provides image pull credentials and deployment support as part of the pilot. Apply for access.
Prerequisites
- A Railway account
- Image pull credentials from LaserOwl (provided on pilot onboarding)
Step 1 — Create a Railway project
Go to railway.app, create a new project, and add an empty service.
Step 2 — Provision Postgres
In your project, click + New → Database → Postgres. Railway provisions an instance and makes DATABASE_URL available as a shared variable.
Step 3 — Configure the Waypoint service
- In the empty service, go to Settings → Source → Docker Image
- Enter
ghcr.io/laserowl-io/waypoint-server:latest - Add your image pull credentials under Settings → Deploy → Image Pull Secret
Step 4 — Set environment variables
In the service's Variables tab:
| Variable | Value |
|---|---|
DATABASE_URL | ${{Postgres.DATABASE_URL}} (Railway reference variable) |
WAYPOINT_JWT_SECRET | Output of openssl rand -hex 32 |
WAYPOINT_RESET_TOKEN | Output of openssl rand -hex 24 |
Step 5 — Deploy
Click Deploy. Watch the logs — on first boot the server prints an initial admin key.
Step 6 — Connect your team
Follow the Team Setup guide from Step 2 (Bootstrap the admin) onwards.