Self-hosting
Deploying.
It's a standard Next.js app, Vercel deploys it with zero config; any Node host works.
Vercel (recommended)
- 1Import the repovercel.com → Add New → Project → import your fork/clone of
xome-webapp. Next.js is auto-detected; default build settings work. - 2Set environment variables
.env.localis gitignored and does not deploy, add every variable from the Environment variables page in Project → Settings → Environment Variables, then redeploy. - 3Point your domainSettings → Domains → add your domain (e.g. app.your-domain.com) and create the CNAME it shows at your DNS provider.
- 4Update the provider dashboardsAdd the production redirect URIs on Google/Slack/GitHub, and your domain to Privy's allowed origins. If you use a different production hostname than app.xome.bot, set
XOME_PROD_HOST.
Other hosts
- Anything that runs Next.js 15 (Node 20+):
npm run build && npm run startbehind a reverse proxy. - Behind a proxy/load balancer, forward
x-forwarded-hostandx-forwarded-proto, OAuth redirect URIs are derived from them.
There is no database to provision and no server state to back up, user data lives in each user's browser. Your deployment is stateless and horizontally scalable by default.