Update your Opal installation
Learn how to update your self-hosted Opal installation.
New releases of Opal are made available on a regular basis—see the changelog for details. To update your installation:
- Connect to your Opal on-premise dashboard:
https://<HOSTNAME>:8800
- Click Check for update, which fetches the latest available version from Replicated
- Click Deploy to deploy, which automatically updates all necessary components
You can also go to the Version History in your on-prem dashboard, which has a list of all available versions. From there, you can roll back to previous versions.
Deploying a new release should take less than a minute and does not cause downtime. However, you should always monitor the upgrade in case issues arise.
Security Updates: Kots
To update KOTS and the admin console, follow these instructions:
- Log in to the cluster
- Install the latest version of kots
curl https://kots.io/install | bash
- Upgrade your cluster
kubectl kots admin-console upgrade -n NAMESPACE
Troubleshooting updates
Blank page after update
If you see a blank page after updating Opal, you can try the following to troubleshoot:
Clear your browser cache:
- Follow instructions for Chrome, Safari, or your chosen browser.
- After clearing the cache, refresh the page to see if the issue is resolved.
Clear your Cloudflare cache:
- Log in to your Cloudflare dashboard and go to Caching > Configuration.

- Click Purge Everything. Wait up to 30 seconds, then refresh your Opal page.

Updated 7 days ago
Need to set up other managed systems? Check out our guides below.