Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 7. Upgrading local sites

There are two distinct procedures for updating your Skupper installation: updating the site configuration and manually updating the controller.

7.1. Standard Site Update
Copy link

To update an existing site to the latest images or configuration matching your current CLI version:

Procedure

  1. Ensure you have the latest version of the Skupper CLI installed.

  2. Run the reload command: 

    skupper system reload
    Copy to Clipboard Toggle word wrap

    This command refreshes the site definition and pulls the latest images associated with the CLI version.

7.2. Updating the Controller
Copy link

Currently, skupper system uninstall protects active sites by refusing to run if a site is detected. However, if you need to force an update to the controller itself (to pick up a new controller version) without deleting your sites, follow this manual workaround.

Prerequisites

  • Ensure your CLI is updated to the target version.

Procedure

  1. Stop and remove the controller container. The container is named <user>-skupper-controller.

    Podman 

    podman rm -f <user>-skupper-controller
    Copy to Clipboard Toggle word wrap

    Docker 

    docker rm -f <user>-skupper-controller
    Copy to Clipboard Toggle word wrap
    Note

    Replace <user> with the specific username under which Skupper is running.

  2. Re-install the controller.

    Run the install command to recreate the controller using the new CLI version. 

    skupper system install
    Copy to Clipboard Toggle word wrap
  3. Verify the controller is recreated with the updated version.
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red HatBack to top