Skip to content

Self-Host XRXP¶

This page gets the XRXP platform running locally so your team can test the full experience before a real deployment.

Outcome¶

When you finish this page, you will have:

PostgreSQL, Redis, API, and WebSocket running
the dashboard available locally
a first admin account and service token ready

1. Start the backend stack¶

docker compose -f docker-compose.dev.yml up -d db redis api websocket

2. Start the dashboard¶

pnpm install
pnpm --filter @xrxp/dashboard dev

3. Open the local services¶

Dashboard: http://localhost:5174
API health: http://localhost:8080/health
WebSocket: ws://localhost:8081

4. Complete first boot¶

open /setup
create the first administrator
go to Admin > Service Tokens
create a token for Unity or automation

5. Validate the platform¶

Recommended first validation:

create the admin account
create one token
connect one Unity device
confirm one session appears in the dashboard

Where to go next¶

if you are preparing Unity, continue with Install the Unity SDK
if the stack is already running, continue with Use the Dashboard
for deeper ops guidance, open Self-Hosting overview

Best onboarding flow

Self-host first, then configure Unity, then verify a session in the dashboard. That sequence exposes the fewest surprises.

Need the deeper ops docs?¶