Dashboard

The Cloud OS dashboard is the first screen you see after logging in. It provides a real-time overview of your server health, running applications, and disk diagnostics. Metrics are streamed live via WebSocket and update automatically without page refreshes.

The dashboard is a customisable 4-column grid: every widget can be resized anywhere from 1x1 to 4x4, reordered, or stacked into multi-row blocks. The Theme Designer ships five animated wallpapers and a Motion-level picker so you can tune the visual depth to your hardware. See Dashboard Customization for the full surface.

System Metric Cards

The top of the dashboard displays four primary metric cards:

Each card includes animated count-up numbers and a miniature sparkline showing recent activity.

How Metrics Are Collected

The Go backend polls system metrics every 10 seconds using the gopsutil library. Raw readings are pushed to connected frontends via WebSocket in real time. For historical charts, data is stored in SQLite at three resolutions:

• 1-minute intervals retained for the last 24 hours
• 1-hour intervals retained for the last 30 days
• 1-day intervals retained for the last year

A background rollup goroutine automatically compacts older data into the lower-resolution tiers.

Running Apps Widget

Below the metric cards, the dashboard shows all installed applications with their current state:

• App name and icon
• Status indicator — running, stopped, or error
• Domain the app is accessible at
• RAM usage for the app containers

Click any app in the list to jump directly to its management page.

Disk Health

The disk health widget provides proactive storage monitoring by combining real-time usage data with predictive analysis.

SMART Data

When smartctl is available on the host, Cloud OS reads Self-Monitoring, Analysis, and Reporting Technology (SMART) attributes from your drives. The widget displays key indicators such as reallocated sector count, power-on hours, and temperature.

Disk Full Prediction

Cloud OS applies linear regression over the last 30 days of disk usage data to estimate when your storage will reach capacity. The prediction is displayed as “disk full in N days” on the dashboard.

Time Range Selector

Use the time range selector in the top-right corner to adjust the historical view of metric charts. Available ranges are:

• 1 hour
• 6 hours
• 24 hours
• 7 days
• 30 days

The selected range determines which resolution tier is queried from the database.

Server Info

The server info panel shows:

• Hostname
• Operating system and kernel version
• Server uptime
• Quazzar Cloud OS version
• Docker version

Greeting

The top of the dashboard displays a personalized greeting based on the time of day:

• Before 12:00 — “Good morning, name”
• 12:00 to 18:00 — “Good afternoon, name”
• After 18:00 — “Good evening, name”

Command Palette

Press Cmd+K (or Ctrl+K on Linux) anywhere in Cloud OS to open the command palette. From the dashboard you can:

• Navigate to any page
• Search installed apps by name
• Toggle between dark and light themes
• Sign out

The palette supports fuzzy matching, so typing “next” will find “Nextcloud” immediately.

Troubleshooting

Metrics show 0% or are not updating

Verify that the WebSocket connection is active. Open your browser developer console and check for WebSocket errors. The backend pushes metrics every 10 seconds, so values should update shortly after page load.

Dashboard loads slowly

If charts take a long time to render, the SQLite metrics table may have grown large. Cloud OS automatically compacts data, but you can check the database size:

du -sh /var/lib/quazzar/data/quazzar.db

If the database exceeds 500 MB, check that the rollup job is running by reviewing the application logs.