Illyaverse operator docs
How to deploy, configure and run your own Illyaverse osu! community server.
These pages are for server operators. Players should use the in-site connection guide and player help.
Components
| Name | Role |
|---|---|
| Serendipity | Website (Next.js) |
| Sanctuary | Website API, accounts, scores, beatmaps (Rust) |
| Resonance | osu! stable and lazer protocol gateway (Rust) |
| Kaleidoscope | Launcher players use to connect |
| Transfiguration | Bridge Kaleidoscope loads into lazer |
| PostgreSQL, Caddy | Database, reverse proxy with automatic HTTPS |
Start here
- Quickstart: run everything locally.
- Deployment: your own domain and HTTPS.
- Configuration: every environment variable.
- Backup and restore: before you upgrade anything.
- Connecting players: what players need and what you must provide.
- Status: what is verified and what is still being tested.
Sign-in, play, chat and score submission have been verified on stable and lazer. Multiplayer is partly verified and spectating is not. Test your chosen client version before opening registration.