Admin Guide

This guide covers server administration for Quazzar Cloud OS in production environments. It is intended for system administrators responsible for deploying, configuring, securing, and maintaining Cloud OS instances.

Deployment Options

Cloud OS supports multiple deployment methods:

Method	Best For
Single binary	Bare metal servers, VPS instances
Docker	Container-based infrastructure, testing
Kubernetes (Helm)	Fleet deployments, high availability

See Deployment for instructions on each method.

System Requirements

Resource	Minimum	Recommended
CPU	1 core	2+ cores
RAM	1 GB	4+ GB
Disk	20 GB	100+ GB SSD
OS	Linux (kernel 4.15+)	Ubuntu 22.04 LTS / Debian 12

Apps, local AI and Mail need Docker Engine 24.0+: you choose in the component installer whether to keep your Docker, replace it with docker-ce, install docker-ce or run without Docker. Cloud OS also needs available ports for the dashboard, HTTPS, and optional VPN.

Guide Sections

Section	Description
Deployment	Installation methods, running as a service, upgrading
Components	Choose which optional parts are installed: S3, VPN, local AI, mail, Docker and more
Configuration	Key settings, proxy setup, and the full environment variable reference for `/etc/quazzar/quazzar.env`
Security Hardening	WAF, firewall basics, TLS, 2FA, security scanning
Password Recovery	Reset a locked-out admin’s password from the console with `sudo quazzar-cli admin reset-password`
Admin Console	Staff roles, sign-in with security keys, audit log, impersonation policy
Backup Strategy	Backup targets, scheduling, encryption, restore procedures
Monitoring Setup	Built-in monitoring, alerts, disk health, external integrations
AI Response Integrity	Kill-switch env var, observability fields, provider compatibility
AI Resilience	Channel restart recovery, duplicate-message protection, AI health check (canary)

Next Steps

Deployment — install Cloud OS using your preferred method
Configuration — adjust settings for your environment
Security Hardening — prepare your instance for production