Upgrading

Upgrading Haloy CLI

Shell Script

To upgrade the Haloy CLI from the previous version:

curl -fsSL https://sh.haloy.dev/install-haloy.sh | sh

The installation script will upgrade your existing installation to the latest version.

Homebrew

If you installed Haloy via Homebrew:

brew upgrade haloy

Javascript Package Managers

If you installed Haloy as a global package:

npm install -g haloy@latest

pnpm add -g haloy@latest

bun add -g haloy@latest

If you installed Haloy as a project dev dependency:

npm install --save-dev haloy@latest

pnpm add -D haloy@latest

bun add -D haloy@latest

Verify Upgrade

Check that the upgrade was successful:

haloy version

Upgrading Server Components

There are several ways to upgrade haloyd on your server.

Note: Do not re-run the original install-haloyd.sh script to upgrade. While it won’t overwrite your configuration or data, it will replace your systemd/OpenRC service file, discarding any manual customizations. Use one of the methods below instead.

From your local machine, use the haloy server upgrade command:

haloy server upgrade

This connects to the server’s API and triggers a self-upgrade. The service will restart automatically after the upgrade.

Via Upgrade Script

SSH into your server and run the upgrade script:

curl -fsSL https://sh.haloy.dev/upgrade-server.sh | sh

This script will:

  1. Download the latest haloyd binary
  2. Stop the service
  3. Replace the binary
  4. Restart the service

Via haloyd Self-Upgrade

SSH into your server and use the built-in upgrade command:

sudo haloyd upgrade

This downloads and installs the latest version, then restarts the service.

Manual Upgrade Instructions

If you prefer to upgrade manually or need specific instructions:

haloy server upgrade --manual

This displays step-by-step instructions for upgrading via SSH.

Verify Server Upgrade

Check the server version from your local machine:

haloy server version

Or on the server:

haloyd version