Updates & Changelog

The Updates & Changelog page is your central hub for keeping QuickBox Pro current. It shows the installed version versus the latest available version for both the QuickBox CLI and the v4 Dashboard, displays a browsable changelog with rendered release notes, and lets you trigger updates directly from the browser.

Admin only

Updates & Changelog requires admin privileges (admin.system.update permission). Navigate to System > Changelog from the sidebar. A notification badge appears when updates are available.

Key features

📊 Version Summary

See current vs latest version at a glance for the QuickBox CLI, v4 Dashboard, and installed applications

📝 Changelog Browser

Browse release notes with full markdown rendering in a split-pane layout

🔄 Dashboard Updates

Trigger a dashboard update with a progress modal that streams live output

🛠️ QuickBox CLI Updates

Update the QuickBox CLI or fix version mismatches from the dashboard

🔔 Update Badge

Sidebar badge indicates when new versions are available

📡 Live Progress

Update operations stream real-time progress so you can follow along

Update status

The top of the page displays status cards for each component showing the installed version and the latest available version:

QuickBox CLI — The core command-line tool that manages your server
v4 Dashboard — The web interface you are currently using
Installed applications — Software packages installed on your server

When a newer version is available, the corresponding status card highlights the difference and provides an update action.

Changelog browser

The changelog is displayed in a split-pane layout:

Left panel — A browsable list of changelog entries, newest first
Right panel — The selected entry rendered as formatted markdown

Browse through entries to review what changed in each release before deciding to update.

Updating the dashboard

When a dashboard update is available, click the update button to open the Dashboard Update Modal. The modal provides:

Pre-update summary — Shows the version you are updating from and the version you are updating to
Live progress stream — Console-style output showing each step of the update process in real time
Automatic verification — After the update completes, the dashboard verifies the new version is running correctly

Brief downtime expected

During a dashboard update, the web interface restarts. The update modal handles reconnection automatically — you do not need to manually refresh. The server and your installed applications continue running normally throughout the process.

After the update finishes, the modal confirms the result:

Success — The new version is verified and running. Click Reload Dashboard to see the updated interface
Reinstall — The same version was reinstalled (common on development or beta channels). No action required
Needs attention — The version did not change as expected. Check the progress output for details

Updating QuickBox CLI

The QuickBox CLI can also be updated from this page. The update triggers qb update quickbox on the server, which pulls the latest CLI version, applies it, and reports the result.

A separate maintenance modal shows progress during the CLI update. Unlike dashboard updates, CLI updates do not require a dashboard restart.

You can also use the Fix Version action if the displayed version does not match what is actually installed. This runs qb fix version to resynchronize the version record.

CLI equivalent

Dashboard Action	CLI Command
Check for updates	`qb update check`
Update QuickBox CLI	`qb update quickbox`
Update dashboard	`qb update dashboard`
Fix version mismatch	`qb fix version`

Automatic checks

QuickBox Pro checks for updates automatically on an hourly schedule. You do not need to check manually unless you want to see the latest status immediately.

Best practices

Do

Review the changelog before updating to understand what has changed in the new version
Keep the dashboard update modal open until it confirms completion — it handles the restart and reconnection automatically
Update the QuickBox CLI and dashboard separately if both have updates available — this ensures each update can be verified independently
Check the system logs after a major update to confirm all services are running normally

Don't

Don't close your browser or navigate away during a dashboard update — the modal needs to track the restart and verify the new version
Don't run multiple updates simultaneously — complete one update before starting another
Don't ignore the update badge — running outdated versions may miss important security patches and bug fixes

FAQ

The update modal will report 'Needs Attention' with details about what went wrong. The previous version remains running. You can copy the progress log for troubleshooting or try the update again. If the dashboard becomes unreachable, you can update from the command line with qb update dashboard.

No. Dashboard and CLI updates do not affect your installed applications. Services like Plex, Sonarr, and qBittorrent continue running normally throughout the update process. Only the dashboard web interface briefly restarts during a dashboard update.

The system checks for updates automatically every hour. You can also trigger an immediate check from this page or by running qb update check from the command line.

Downgrades are not supported through the dashboard. If you need to revert to a previous version, contact support through the QuickBox Discord for guidance.

The QuickBox CLI (qb command) manages your server from the terminal — it handles software installation, user management, and system operations. The Dashboard (v4) is the web interface. They are updated independently because they are separate components, though both are part of the QuickBox Pro product.

System Logs

View audit events and application logs

System Monitoring

Monitor server health and resource usage

CLI Reference

Full command-line reference for QuickBox Pro

General Settings

Server configuration and feature flags

Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support

Feature Previews

Community Configs

Active Discussions

Join Discord Server