Skip to content

Reservium

Reservium Production Ready Self-Hostable

Reservium is CloudRader's flagship reservation and space management platform. Designed from the ground up for organizations, educational spaces, coworking environments, and homelab teams, Reservium replaces fragmented spreadsheets and calendar invites with a unified, self-hosted booking system.

Key Capabilities

  • Visual Scheduling

    Clear day, week, and month views of availability, upcoming events, time slots, and automatic conflict detection.

  • Role-Based Workflows

    Granular permissions separating regular users (browse & book), managers (review & approve requests), and administrators.

  • Single Sign-On (SSO)

    Native OpenID Connect (OIDC) integration. Connect with any compliant identity provider (such as Keycloak, Authentik, or Authelia) and synchronize user profile roles automatically.

  • OpenAPI 3.0 REST Backend

    High-performance async API powered by FastAPI with interactive Swagger UI documentation and standardized JSON schemas.

Technical Architecture & Stack

Reservium is decoupled into an asynchronous Python API backend and a responsive React frontend:

Python 3.12+ FastAPI SQLAlchemy 2.0 React PostgreSQL 16 Alembic OIDC Docker Compose
  • Backend Service: Built with FastAPI, SQLAlchemy 2.0 async sessions, Alembic database migrations, and Pydantic v2 data validation.
  • Frontend Dashboard: Responsive calendar and booking interface built with React, Vite, and modern styling components.
  • Data Isolation: Fully independent PostgreSQL database with schema migrations managed per release.
  • Container Packaging: Multi-stage, rootless Docker images ready for Docker Compose or Kubernetes deployment.

Project Repositories

Component Repository Description Technology Source
API Backend CloudRader/reservium-api Core FastAPI backend service, database models, and migration scripts Python / FastAPI / PostgreSQL GitHub
Web UI CloudRader/reservium-ui Frontend client interface, interactive calendar, and manager dashboard React / Vite / Tailwind GitHub
Documentation CloudRader/reservium-docs Comprehensive user manual, manager guide, and API reference Zensical / Markdown GitHub

Dedicated Documentation Portal

Full Documentation Hub: docs.reservium.cloudrader.com

Reservium maintains its own dedicated, detailed documentation site for end users, managers, and self-hosters:

  • User Guide : How to explore calendars, reserve resources, and manage personal bookings.
  • Manager Guide : How to approve reservation requests, configure calendars, and define service policies.
  • API Reference : Complete interactive REST endpoint reference and OpenAPI specification.
  • Standalone Hosting Guide : Standalone deployment documentation tailored specifically for Reservium.
  • Deploy with CloudRader Ecosystem: Deploy Reservium as part of the multi-service CloudRader Docker Compose stack.