🚀 New

Sunray Deployment

Up and running in under 30 minutes on any infrastructure.

📋 Prerequisites

  • Ubuntu 24.04 server (2 vCPU / 4 GB RAM minimum)
  • Public domain + DNS access (for TLS certificate)
  • Docker installed
  • SMTP access for email OTP (optional but recommended)
01

Deploy sunray-server

The management server installs on any Ubuntu 24.04 server.

git clone https://github.com/inouk/sunray-server
cd sunray-server && ./install.sh

Requires: Ubuntu 24.04, Docker, a public domain with DNS.

02

Choose your Worker

Two options depending on your infrastructure.

Option A -- Cloudflare Worker
Ideal if your DNS is with Cloudflare
npx wrangler deploy

Configure wrangler.toml with your sunray-server URL and the domain to protect.

Option B -- FastAPI Worker
Ideal for on-premise / VM / container
docker run -d \
  -p 8065:8065 \
  -e SUNRAY_SERVER_URL=https://... \
  inouk-sunray-worker/sunray-worker-fastapi:latest
03

Register a passkey

From the sunray-server dashboard:

  • Log in to the sunray-server dashboard
  • Go to Users > Add
  • Invite the user -- they register their passkey on first access
04

Test access

Access the protected URL from a browser. Sunray will ask for your passkey. After validation, you are transparently redirected to the application.

Need help with deployment?

Contact us → View architecture