Installation

This guide covers installing Quazzar Cloud OS on a single Linux server. Cloud OS is distributed as a .deb package through the Quazzar APT repository at apt.quazzar.space.

System Requirements

Requirement	Minimum	Recommended
OS	Ubuntu 22.04, Debian 12, Rocky 9, RPi OS 64-bit	Ubuntu 24.04 LTS
Architecture	x86_64 or ARM64	x86_64
RAM	2 GB	4 GB+
Disk	20 GB	80 GB+ (SSD recommended)
Docker	27+ (installed automatically)	Latest stable

Cloud OS uses SQLite in WAL mode for its internal database. No external database server is required.

Option 1: APT Installation (Recommended)

Add the Quazzar APT repository and install the package:


# Import GPG key
curl -fsSL https://apt.quazzar.space/apt/gpg-key.asc | sudo gpg --dearmor -o /usr/share/keyrings/quazzar.gpg
 
# Add Quazzar repositories (stable + testing)
sudo tee /etc/apt/sources.list.d/quazzar.list <<'EOF'
deb [signed-by=/usr/share/keyrings/quazzar.gpg] https://apt.quazzar.space/apt stable main
deb [signed-by=/usr/share/keyrings/quazzar.gpg] https://apt.quazzar.space/apt testing main
EOF
 
# Update package lists and install
sudo apt update
sudo apt install quazzar

After installation you will see:


Quazzar service installed. To start:
  sudo systemctl start quazzar.service

Edit configuration:
  sudo nano /etc/quazzar/quazzar.env

Start and enable the service:


sudo systemctl start quazzar.service
sudo systemctl enable quazzar.service

The APT package handles Docker installation, data directory setup, and systemd service creation automatically.

Option 2: One-Line Installer

The installer script detects your OS and architecture, installs Docker if needed, and sets up Cloud OS:


curl -fsSL https://get.quazzar.cloud | bash

The installer requires root or sudo privileges. It will prompt you before making system changes.

Option 3: Docker Installation

Run Cloud OS as a Docker container using the image from the Quazzar private registry:


docker run -d \
  --name quazzar \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v quazzar-data:/data \
  --restart unless-stopped \
  docker.quazzar.space/cloud-os:latest

Mounting the Docker socket (/var/run/docker.sock) is required so Cloud OS can manage containers on the host.

Post-Install Verification

Once installation completes, open your browser and navigate to:


http://YOUR_SERVER_IP:8080

You will see the Quazzar setup wizard where you create your admin account.

If you are running behind a firewall, make sure port 8080 is open for inbound TCP traffic. If you plan to use automatic SSL, ports 80 and 443 must also be accessible.

Confirm that Quazzar is running from the command line:


# Check the systemd service
sudo systemctl status quazzar.service
 
# Or check the Docker container
docker ps --filter name=quazzar

You should see the service in an active (running) state.

Configuration

The configuration file is at /etc/quazzar/quazzar.env. Edit it and restart the service for changes to take effect:


sudo nano /etc/quazzar/quazzar.env
sudo systemctl restart quazzar.service

See Configuration for details.

Upgrading

Upgrade via APT like any other package:


sudo apt update
sudo apt full-upgrade -y

The service is automatically restarted after the upgrade.

Next Steps

Quick Start --- create your admin account, install your first app, and configure a domain
Control Panel Setup --- connect this server to the Control Panel for fleet management