Updating and uninstalling
Upgrade to a new release, roll back, and remove Yolorouter from a machine.
Upgrading
Installed via the script
Re-run the same install command:
# Linux / macOS
curl -fsSL https://get.yolorouter.com/install.sh | bash
# China mirror:
# curl -fsSL https://gh.yolorouter.com/install.sh | bash# Windows
irm https://get.yolorouter.com/install.ps1 | iex
# China mirror:
# irm https://gh.yolorouter.com/install.ps1 | iexConfiguration and database are preserved, and the database is backed up before the upgrade.
Self-updating the binary
./yolorouter updateOn Linux and macOS this checks the latest GitHub release, downloads it, replaces the current binary, and keeps the old one as a .bak.
yolorouter update does nothing on Windows. A running .exe is locked, so it cannot be replaced atomically; the command detects this, prints the latest release URL and exits without changing anything. If you installed with install.ps1, re-run it (above) — it stops the task, swaps the binary and restarts. Otherwise download that release, stop the service, and swap the executable yourself.
The .bak rollback is only valid before the service restarts. Database migrations run at service start and are decoupled from binary replacement — once the new version has started and migrated, swapping the old binary back may not be compatible with the migrated database.
To route updates through the mirror, add to the update section of config.yaml:
update:
github_proxy: https://gh.yolorouter.com/To disable update checks entirely (both the API and the CLI):
update:
enabled: falseDatabase migrations
Upgrades normally need no manual step, but these commands are always available:
./yolorouter db:status # current migration version
./yolorouter db:migrate # apply pending migrations
./yolorouter db:rollback [v] # roll back one migration, or down to version v
./yolorouter db:backup --output-dir backupsBack up before any rollback.
Uninstalling
Replace the trailing bash in the install command with bash -s -- --uninstall:
# Linux / macOS
curl -fsSL https://get.yolorouter.com/install.sh | bash -s -- --uninstall
# China mirror:
# curl -fsSL https://gh.yolorouter.com/install.sh | bash -s -- --uninstallA piped irm ... | iex cannot take arguments, so on Windows set the environment variable instead:
# Windows
$env:YOLO_UNINSTALL = '1'; irm https://get.yolorouter.com/install.ps1 | iex
# China mirror:
# $env:YOLO_UNINSTALL = '1'; irm https://gh.yolorouter.com/install.ps1 | iexUninstall from the same privilege level you installed from: an elevated prompt removes the system-wide install, a normal one removes the per-user install.
If you run the binary by hand, stop the process and delete the directory:
./yolorouter stopUninstalling removes the service and the binary. Make sure you have a backup before deleting the data directory — upstream keys, model configuration and request history all live in the database.