Docs/Self-host

Self-host Aurora in 4 commands.

Your project OS, on your Supabase, on your Cloudflare. MIT licensed, no telemetry, no per-seat ceiling. Bring your own AI key and pay providers directly.

View on GitHub Quickstart

Git

Any recent version

Bun ≥ 1.0

or Node 20 + npm

Supabase project

Free tier works

Cloudflare account

For Workers + Pages

Quickstart

Four steps to your own instance

Roughly 10 minutes start to finish, assuming you have Supabase and Cloudflare accounts ready.

01
Clone the repo
Grab the source from GitHub. It's MIT — fork it, change it, ship it.
terminal
```
git clone https://github.com/zenifold/aurora-os.git aura
cd aura
bun install
```
02
Provision your database
Create a Supabase project, then push the included migrations. Schema, RLS, roles, triggers — all wired in.
terminal
```
bunx supabase link --project-ref <your-ref>
bunx supabase db push
```

Set environment variables

Drop your Supabase keys into a .env file. No secrets are baked into the build.

terminal

# .env
VITE_SUPABASE_URL=https://<ref>.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=<anon-key>
VITE_SUPABASE_PROJECT_ID=<ref>
SUPABASE_SERVICE_ROLE_KEY=<service-role-key>

04
Deploy to Cloudflare
One command. Workers handles SSR, the static bundle ships to the edge worldwide.
terminal
```
bun run deploy
# → https://aura.<your-account>.workers.dev
```

After deploy

You're live. Now make it yours.

Add your OpenRouter key

Open the app, go to Settings → AI, and paste your key. Pick any model — pay providers directly, no markup.

Get an OpenRouter key

Invite your team

Auth is built in: email + Google OAuth out of the box. Roles and RLS policies enforce who can do what.

Customize anything

It's your codebase. Add fields, build views, swap providers. No black boxes between you and your data.

Architecture

No magic. Just open standards.

Aurora is a TanStack Start app on Cloudflare Workers, backed by Supabase (Postgres + Auth + Storage). AI calls go directly to OpenRouter using your key — Aurora never proxies prompts or stores them.

TanStack Start (React 19) on Cloudflare Workers
Postgres with Row-Level Security from day one
OpenRouter for AI — model-agnostic, BYO key
Realtime via Supabase channels
MIT licensed end-to-end

Common questions

FAQ

Do I need to pay anyone?: No. The code is MIT — free forever. You only pay your infrastructure bills (Supabase + Cloudflare both have generous free tiers) and your AI provider directly via OpenRouter.
Can I migrate later from Aurora Cloud to self-host?: Yes. Export your data from Settings → Data, spin up your own instance, and import. No lock-in by design.
What about updates?: git pull and re-run migrations. Releases are tagged on GitHub with changelogs.
Can I run it without Cloudflare?: Yes — any host that supports Node 20 will work. Cloudflare is the default because Workers + the edge runtime are what we ship and test against.

Ready to own your stack?

Star the repo, clone it, ship it. Or skip the ops and use Aurora Cloud — same codebase, hosted by us.

Clone on GitHub See hosted pricing