Updating adminbolt
Keeping your adminbolt control panel up to date ensures you have access to the latest features, security patches, and improvements. This guide explains how to update your adminbolt installation.
Updating from the admin panel
The simplest way to update is the System Updates view (see System Updates for the full reference):
- Log in to the Admin Panel.
- Open System → System Updates (
/admin/system-updates). The page checks for updates automatically and shows your Current Version and the Latest Version. - If a newer version is available, the release notes appear inline under What's New. Click Install update to apply it.
- Use Check for updates at any time to re-run the check.
The update is downloaded and installed, and the necessary services are restarted.
Updating from the command line
Server administrators can update from the shell:
- The adminbolt panel and agent packages are upgraded with the system package manager (
yum/dnfon RHEL/AlmaLinux). bolt-cli check-for-updates [--force]checks for a new version and notifies administrators.bolt-cli run-upgrade-steps [--retry-failed] [--only <id>] [--list]runs any pending one-shot upgrade steps.
See the CLI Reference for the full command list.
After updating
- Clear your browser cache to ensure you are seeing the latest interface.
- Check the dashboard for any migration notices or additional steps.
- Test key features to make sure everything is working as expected.
Troubleshooting
- If an update fails, the panel shows an error state with a View log option; the update log is at
/usr/local/bolt/web/bolt-update.log. - If the system cannot be updated automatically (for example a package conflict), the panel shows the steps to resolve it over SSH.
- On servers where the adminbolt package repository is not configured, update checks are skipped cleanly rather than failing. Configure the repository to receive panel updates.
- Make sure your server meets the system requirements.
- If problems persist, contact support or check the forums.