Skip to main content
The CLI can upgrade itself in place by reinstalling the npm package.

​
Automatic upgrades

Routine commands check the registry on a TTL and auto-upgrade in the background when a new dist-tags.latest is available. Disable it any of these ways:
While an upgrade is in flight, other mulerun invocations block at a process-wide lock — the rule is “no two mulerun commands while one is upgrading.”

​
Registry overrides

By default the CLI upgrades from the same npm registry it was installed from. Override with:
Non-default registries that are not on the built-in allow-list require an explicit high-risk opt-in:

​
Tips

  • mulerun upgrade --check is safe to call from cron — it does not install anything.
  • Distributions whose upgrade policy is “forbidden” (sandbox, dev) cannot self-upgrade at all; the env-var knobs above have no effect on those builds.