Self-Update System

Stackie keeps itself up to date automatically. The daemon periodically checks for new versions, downloads updates in the background, and applies them with zero downtime. If anything goes wrong during an update, Stackie rolls back to the previous version automatically.

How Updates Work

1. stackie update checks the Cloud API and downloads the signed package URL
2. Verifies SHA-256 checksums
3. Gracefully stops the daemon
4. Atomically replaces binaries in ~/.stackie/bin/
5. Restarts the daemon
stackiedupdater sidecarSigned package URLStackie Cloud APIstackie updatealt[daemon healthy][daemon unhealthy]Check latest versionPackage metadata and signed URLDownload packageVerify SHA-256Gracefully stopSwap binaries atomicallyRestart stackiedHealth statusCommit updateRoll back previous binariesRelaunch previous stackied
Stackie documentation diagram: stackied, updater sidecar, Signed package URL, Stackie Cloud API, stackie update. Use horizontal scrolling when the full diagram is wider than the visible frame. Generated from Stackie public documentation source.

The daemon also periodically checks for new versions in the background and notifies you via the system tray and dashboard when an update is available.

CLI Commands

# Update to the latest version
stackie update

# Install a specific version
stackie update --version 0.9.0

# Show the currently installed version
stackie --version

Updates are downloaded over HTTPS and verified with SHA-256 checksums before extraction. The rollback mechanism ensures the daemon is always left in a working state.