webui/components/settings/external/self-update-modal.html
New major version available
Current
Latest on main
Quick mode always targets main and uses the default backup settings. Use Advanced for a different branch, manual version selection, or custom backup behavior.
Current version
Commit ``
Latest version
Commit ``
Latest official version is only tracked for main, testing, and development.
Pending request
Self-update is currently available only in dockerized Agent Zero deployments that boot through /exe/run_A0.sh.
How it works?expand_more
Agent Zero saves this request into ``, restarts once, applies the requested branch and version target before the UI starts again, then reloads this page when /api/health is healthy.
If the updated UI does not become healthy within 2 minutes, the bootstrap manager in /exe restores the previous checkout and starts that version again, so even an older downgraded /a0 can be upgraded back by creating the YAML file manually.
Version numbers use the format vMAJOR.MINOR. The first number is the major release line and moving to a newer major version requires a newer Docker image. The second number is the minor release line and those updates can be applied through Agent Zero self-update inside the existing image.
On development branches you may also see versions like v1.5+2. The +2 means that checkout is based on v1.5 plus two additional commits after that release tag. This suffix is not used on main.
Last Attempt expand_more
Trigger: ``
Log: ``
Backup: ``
Target branch
Choose which official branch context should be used when resolving the requested tag.
Version
Choose a preloaded version target from the Agent Zero repository. Only versions from the current major release line are listed here. Newer major lines require a Docker image update first.
latest resolves to the newest tag on main, and to the current branch head on testing and development.
Version lookup failed:
Back up /a0/usr first
Creates a zip backup before the release files are replaced.
Backup directory
Absolute or repo-relative path where the usr zip should be written.
Manual backup
Open the existing backup and restore modal if you want to create a backup before scheduling the update.
Manual backup
Backup filename
The manager normalizes this into a safe .zip filename. Leave it as-is for the default usr-timestamp.zip format.
If the filename already exists
Choose whether to rename the backup, replace it, or stop the update.
Rename with suffixOverwrite existing zipFail before restart
The durable trigger, status, and log files live outside /a0: , , ``.
Restart and Update Restart and Update Refresh Cancel