Version: Next

Upgrading components

Before upgrading components, we highly recommend you back up your params.yaml file and try the upgrade on a copy of your production cluster.


It is highly recommended that you commit params.yaml file into a private repository and encrypt it with BlackBox or use a secret management service like Azure Key Vault, AWS Secret Manager, GCP Secret Manager or HashiCorp Vault.

Upgrading components

When upgrading Onepanel, it is best to upgrade one minor version at a time (e.g. 0.14.0 => 0.15.0).

To upgrade Onepanel:

  1. Check the current version of opctl:

    opctl version
    CLI version: 0.10.0
    Manifest version: v0.10.0
    API version: v0.10.0
    Web UI version: v0.10.0
  2. Download the next version up of opctl for your operating system from our release page.

  3. Run opctl init with the initial flags you used.


    You can find the opctl command you initially ran at the top of your params.yaml file.

    For example:

    opctl init --provider gke \
    --artifact-repository-provider s3

    Run opctl init only with the initial flags, you can add additional flags after the upgrade completes.

  4. Apply your changes:

    opctl apply

    If the application is not loading after these updates, visit our Troubleshooting page for some steps that can help resolve most issues. If you are still having issues, reach out in Slack or GitHub discussions.