Self-Hosting

Owlette is available as a hosted service at owlette.app — no setup required. But if you want to run your own instance, this section covers deploying the full stack yourself.

---

Why Self-Host?

• Data sovereignty — Keep all data in your own Firebase project
• Custom domain — Run the dashboard on your own URL
• Full control — Modify the codebase, add features, integrate with your infrastructure
• Development — Contribute to Owlette or build on top of it

---

What You'll Need

Requirement	Purpose
Firebase account	Database and authentication backend (free tier works)
Railway account (or any Node.js host)	Web dashboard hosting
GitHub repository	Source code and CI/CD
Node.js 18+	Local development
Windows 10+ machine	Agent installation target

---

Setup Order

1. Firebase Setup          → Create project, enable Firestore + Auth
      │
2. Firestore Rules         → Deploy security rules
      │
3. Web Deployment          → Deploy to Railway, configure env vars
      │
4. First Admin Account     → Register + promote in Firestore
      │
5. Agent Installation      → Download + install on target machines

---

In This Section

• Firebase Setup — Create project, enable services, generate credentials
• Firestore Rules — Deploy and test security rules
• Web Deployment — Deploy to Railway with environment configuration
• Environment Variables — Complete reference for all configuration variables

Technical Reference

• REST API — All HTTP endpoints with request/response schemas
• Firestore Data Model — Complete collection and document schema
• Authentication — User auth, agent OAuth, MFA, and session management
• Cortex Tools — All 19 MCP tools with parameters and tiers
• Agent Commands — Firestore command types and payloads