Welcome to ORISO Platform Documentation
Welcome to the ORISO (Online Beratung) Platform documentation. This comprehensive guide will help you deploy and configure the complete ORISO Platform on a fresh Ubuntu Server.Quick Start
Get Started
Start here to understand requirements and begin deployment
Initial Setup
Configure your Ubuntu server for ORISO Platform
Deploy Infrastructure
Deploy databases, cache, and authentication services
Quick Reference
Essential commands and troubleshooting tips
What is ORISO Platform?
ORISO Platform v3.0.0 is a comprehensive online consultation platform deployed on Kubernetes using Helm charts:- 21 Services - Deployed via single Helm umbrella chart
- Kubernetes/Helm - k3s with Helm 3.x for deployment
- Microservices - Spring Boot 2.7.14 backend services (Java 17)
- Authentication - Keycloak OIDC/OAuth2
- Communication - Matrix Synapse + LiveKit for chat and video
- Databases - MariaDB (7 DBs), MongoDB, PostgreSQL (Matrix)
- Frontend - React 18 + Vite 4 applications
- Monitoring - SignOZ observability + Health Dashboard
Documentation Structure
The documentation is organized into four main sections:- Getting Started - Server requirements, initial setup, and software installation
- Deployment - Step-by-step deployment of all services
- Configuration & Testing - Post-deployment configuration and verification
- Operations - Backup, security, troubleshooting, and reference guides
Prerequisites
Before you begin, ensure you have:- ✅ Kubernetes cluster (k3s recommended, 1.24+)
- ✅ Helm 3.x installed
- ✅ kubectl configured
- ✅ Nginx Ingress Controller installed
- ✅ Cert-Manager installed (for TLS)
- ✅ DNS records configured (for HTTPS)
- ✅ Minimum 4 CPU cores and 8GB RAM (16GB+ recommended)
- ✅ 50GB+ disk space (100GB+ recommended)
Next Steps
Ready to get started? Begin with the Overview and Requirements page to understand server requirements and then proceed through the setup guide step by step. If you’re looking for specific information:- Troubleshooting - See Troubleshooting Guide
- Commands - See Quick Reference
- Security - See Security Hardening