What is Zaroz Cloud?¶
Zaroz Cloud is a game-hosting platform. It also provides services like Discord Bot hosting (Node.js).
Old Architecture¶
The old architecture was a Discord bot that handled everything, which was a problem for building a web dashboard. Everything has been moved to the kernel project, which handles the main domain logic and exposes it through an HTTP interface.
The legacy projects (directus, discord-bot, domain) are preserved for context only and must not be modified.
New Architecture¶
Orders have provisions, which map directly to Kubernetes resources.
For example, FiveM servers always come with a MariaDB database, which needs its own PVC, port, etc.
The sidecar crate provides gRPC file access to containers. The terminal-bridge enables shell access to game server containers.
Website / Dashboard¶
The dashboard is built in Next.js with TypeScript, Tailwind, React, and shadcn/Radix components.
Features include: - Game server management (start/stop, file browser, terminal) - Database visualization (read-only, no schema editing) - Provision status display
Additional Documentation¶
- Cloud: design documents for the kernel backend, billing, provisions, and service integrations.
- Kubernetes: infrastructure setup for the k3s cluster, networking, and internal apps.