hubio-sync upgrade

Check for and install updates.

Synopsis

hubio-sync upgrade [flags]

Description

The upgrade command checks for newer versions of hubio-sync and optionally installs them. Updates are fetched from the primary CDN (releases.hubio.team) with GitHub releases as a fallback.

Flags

FlagDefaultDescription
--checkfalseOnly check for updates, don’t install
--channelstableRelease channel (stable or beta)
--skip-checksumfalseSkip checksum verification (not recommended)

Usage

Check for Updates

Check if a newer version is available without installing:

hubio-sync upgrade --check

Output when up to date:

hubio Sync Upgrade
==================
Current version: 1.0.8
Channel: stable

✓ You are running the latest version (1.0.8)

Output when update available:

hubio Sync Upgrade
==================
Current version: 1.0.7
Channel: stable

✓ Update available: 1.0.8
  Release date: 2025-12-03

Source: releases.hubio.team

Run 'hubio-sync upgrade' without --check to install the update.

Install Update

Upgrade to the latest version:

hubio-sync upgrade

Output:

hubio Sync Upgrade
==================
Current version: 1.0.7
Channel: stable

✓ Update available: 1.0.8
  Release date: 2025-12-03

Source: releases.hubio.team

Do you want to upgrade now? [y/N] y

[  0%] Downloading hubio-sync-darwin-arm64...
[ 50%] Verifying checksum...
[ 75%] Installing...
[100%] Complete

✓ Successfully upgraded to version 1.0.8
Please restart hubio-sync to use the new version.

Beta Channel

Install beta releases for early access to new features:

hubio-sync upgrade --channel beta

Update Sources

Updates are fetched in order of preference:

  1. Primary CDN: https://releases.hubio.team/sync/

    • Fast, globally distributed
    • Includes version metadata and checksums

  2. GitHub Releases: https://github.com/jj-scoll/deepfried/releases

    • Fallback if CDN is unavailable
    • Same binaries, different source

Security

Checksum Verification

By default, downloaded binaries are verified against SHA-256 checksums published alongside the release. This ensures:

  • File integrity (not corrupted during download)
  • Authenticity (matches the official release)

Warning: The --skip-checksum flag disables verification. Only use this for troubleshooting, never in production.

Update Process

  1. Check current version against latest available
  2. Download new binary to temporary location
  3. Verify checksum matches published value
  4. Replace current executable with new version
  5. Verify new version runs correctly

Examples

Quick Update Check

hubio-sync upgrade --check

Upgrade to Latest Stable

hubio-sync upgrade

Upgrade to Beta

hubio-sync upgrade --channel beta

Scripted Upgrade (Non-Interactive)

For automated upgrades, you can use the install script which handles the upgrade process:

# macOS/Linux
curl -fsSL https://install.hubio.team/install.sh | sh

# Windows (PowerShell)
Invoke-RestMethod https://install.hubio.team/install.ps1 | Invoke-Expression

Troubleshooting

”Permission denied” Error

On macOS/Linux, if the binary is installed in a system location:

sudo hubio-sync upgrade

Network Errors

If you’re behind a proxy or firewall:

  1. Ensure access to releases.hubio.team and github.com
  2. Try the GitHub fallback: the upgrade command will automatically try GitHub if CDN fails

Rollback

If an upgrade causes issues, reinstall the previous version:

# Download specific version
curl -fsSL https://releases.hubio.team/sync/1.0.7/hubio-sync-darwin-arm64 -o hubio-sync
chmod +x hubio-sync
sudo mv hubio-sync /usr/local/bin/

See Also