Updating dynctl
Last updated: 10/29/2026Before you begin
About this task
The dynctl update command is available from dynctl 1.1.0. It checks the public dynctl release channel for a newer version. If a newer version exists, the command downloads the binary for your platform, verifies its checksum, and replaces the running dynctl binary in place.
The command requires no authentication, no portal login, and no cluster access.
Procedure
dynctl updateResults
If a newer version is available, the output is similar to:
Updating dynctl: 1.1.0 -> 1.2.0
Updated to 1.2.0.If you already use the latest version, the output is:
dynctl is already up to date (1.1.0).Development builds of dynctl do not support self-update. They make no network call and print:
This is a development build of dynctl; self-update is not supported.What to do next
About the update notice and how to turn it off
About this task
When you run any other command, dynctl may print this notice to stderr:
A newer version of dynctl is available (<version>). Run 'dynctl update' to upgrade.Because the notice goes to stderr only, it never corrupts command output, such as tables from get or the output of doctor --format=json.
The notice follows these rules:
- It appears at most once every 24 hours. The marker file ~/.dynctl/.update-check records the last check.
- The check is time-bounded to about 3 seconds and fails silently.
- It is suppressed for development builds, when --no-update-check is set, and for the update, completion, and help commands.
To turn off the notice, use one of these methods:
- The --no-update-check flag, which applies to all commands. The
default is false. For example:
dynctl get --no-update-check - The DYNCTL_NO_UPDATE_CHECK environment variable. For example:
export DYNCTL_NO_UPDATE_CHECK=true - The no.update.check configuration key.