Repository navigation
Updating container / tool / service versions? #164
Description
Activity
Hi, thanks for trying out Harbor and for your recent reports!
Harbor's service version strategy is to use latest version until the service is known too break too often or require manual patching to update.
In all service wikis, the "Starting" section's first command outlines how service can be updated.
Typically it's either
harbor build <service>
or
harbor pull <service>
When building, sometimes you'll want to use
--no-cacheto rebuild from scratch.Many services that use
pullwill also allow to specify docker image and image tag to use manually (see configs for the specific service)For example, for the Open WebUI:
# List Open WebUI-related configs harbor config ls | grep WEBUI WEBUI_HOST_PORT 33801 WEBUI_SECRET h@rb0r WEBUI_NAME Harbor WEBUI_LOG_LEVEL INFO WEBUI_VERSION main WEBUI_IMAGE ghcr.io/open-webui/open-webui # 1. Change to a custom image harbor config set webui.image private.registry.io/open-webui # 2. Change desired docker tag harbor config set webui.version latest
You can see that by default
WEBUI_VERSIONismainwhich is analagous tolatestin Open WebUI's labelling scheme. So, to update it, you'll need to run:harbor pull webui
There is a specific failure in openhands I was hoping to test with an update.
That can be set with:
harbor config set openhands.version mainAnd then rebuild/restart for new image to take place
Reacted by Andrew Hundt- added a commit that references this issue
on May 21, 2025 Current Harbor exposes the version tags directly. I checked
./harbor.sh config get webui.version→mainand./harbor.sh config get openhands.version→latest; OpenHands Compose uses that one version for bothghcr.io/all-hands-ai/openhands:<version>andruntime:<version>-nikolaik. For a trial, set an explicit tag (for exampleharbor config set webui.version v0.6.9orharbor config set openhands.version <tag>), thenharbor pull <service>andharbor up <service>. To restore Harbor's current default tag, set WebUI back tomainor OpenHands back tolatest, then pull/up again. The service docs also show the pull commands. Note thatmain/latestare moving tags: restoring those defaults is not a guaranteed rollback to the exact image digest you had before. For an exact rollback, record the working tag/digest first and restore that explicitly. The older comments'openhands.version mainexample is not the current default; it islatestnow.
Is there a straightforward and easy way for users to try updating containers and reverting those updates, or to jump to the latest? Particularly if there are ways to go back to the safe tested defaults harbor supplies.
For example, the current harbor openwebui is 0.6.7 and the latest release is 0.6.9. This is similarly true for others like openhands where there have been some significant fixes recently.
I checked locations I thought would be relevant in the wiki but mentions of updates concerned updating harbor itself, rather than the packages:
https://github.com/av/harbor/wiki/3.-Harbor-CLI-Reference
https://github.com/av/harbor/wiki
Thanks!