Self-Hosting Guide

Deploy your own isolated family instance on Railway. One family, one database, one storage bucket, your keys.

What's included

• platform-web — Next.js UI
• platform-api — REST API + MCP server
• platform-worker — background jobs and scheduled agents
• PostgreSQL, Redis, and a Railway Bucket for documents

Secrets (JWT, encryption keys, agent tokens) are auto-generated when you deploy — you don't paste them manually.

First run

1. Deploy from the Railway template and wait for all services to reach SUCCESS.
2. Open your platform-web public URL.
3. Create the Owner account (only available when no users exist).
4. Invite family members in Settings → Users and customize roles in Settings → Roles.

Roles

• Owner — one per instance; full access
• Preset roles — Admin, Adult, Accountant, Viewer
• Custom roles — duplicate a preset and toggle section access (None / View / Edit)

Optional integrations

Add these in Railway service variables after deploy, then redeploy the affected service.

Variable	Service	Feature
ANTHROPIC_API_KEY	platform-api	Document OCR / AI chat
STRIPE_SECRET_KEY	platform-api	Stripe Financial Connections (bank linking)
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY	platform-web	Stripe Link UI
INBOUND_EMAIL_SECRET	platform-api	Email inbox (with Cloudflare Email Worker)
NEXT_PUBLIC_INBOX_EMAIL	platform-web	Display address in Inbox UI
MORALIS_API_KEY	platform-api	Crypto wallet sync

Connect an AI agent (MCP)

1. Log in → Settings → MCP Access
2. Generate a platform API key (craneos_sk_…)
3. Point Cursor or Claude Desktop at https://your-api-domain/mcp

Privacy

Each instance is single-tenant. Your Postgres, bucket credentials, JWT secret, and encryption keys are generated at deploy time and stay in your Railway project. The template publisher never receives them.

License

By deploying and using WisemanOS you agree to the Software License Agreement (Crane X1 LLC).

Deploy

Deploy on Railway · Homepage