Add a universal installation script #4

Closed
opened 2026-11-16 02:44:55 +00:00 by aaron · 0 comments
Owner

Problem

Installing tntop requires users to choose a release archive, download checksums, extract the binary and set up PATH. The commands differ between Bash, Fish and Windows.

Change

Provide a simple installer that detects the operating system and CPU architecture, downloads the matching release and installs tntop. Cover macOS, Linux and Windows with suitable entry points for each platform.

Done when

  • The installer selects the correct published asset for the current OS and architecture. Unsupported combinations fail with a clear message.
  • It installs the latest stable release by default and allows a specific version.
  • It verifies the archive against that release’s SHA-256 checksums before installing.
  • It installs to a user-owned directory by default, using ~/.local/bin on macOS and Linux, without requiring sudo.
  • It explains how to add the install directory to PATH when needed.
  • Running it again updates the binary. Failed downloads, checksum checks or extraction leave an existing installation intact.
  • The README includes copyable commands for Bash/Zsh, Fish and PowerShell. Unix commands invoke the installer with its required shell rather than assuming the user’s interactive shell.
  • Linux instructions explain the Secret Service keyring requirement and link to setup guidance.
  • Checks cover platform selection, unsupported platforms, checksum failures and safe replacement of an existing installation.
## Problem Installing tntop requires users to choose a release archive, download checksums, extract the binary and set up PATH. The commands differ between Bash, Fish and Windows. ## Change Provide a simple installer that detects the operating system and CPU architecture, downloads the matching release and installs tntop. Cover macOS, Linux and Windows with suitable entry points for each platform. ## Done when - The installer selects the correct published asset for the current OS and architecture. Unsupported combinations fail with a clear message. - It installs the latest stable release by default and allows a specific version. - It verifies the archive against that release’s SHA-256 checksums before installing. - It installs to a user-owned directory by default, using `~/.local/bin` on macOS and Linux, without requiring sudo. - It explains how to add the install directory to PATH when needed. - Running it again updates the binary. Failed downloads, checksum checks or extraction leave an existing installation intact. - The README includes copyable commands for Bash/Zsh, Fish and PowerShell. Unix commands invoke the installer with its required shell rather than assuming the user’s interactive shell. - Linux instructions explain the Secret Service keyring requirement and link to setup guidance. - Checks cover platform selection, unsupported platforms, checksum failures and safe replacement of an existing installation.
aaron added this to the v0.2.0 milestone 2026-11-16 14:41:41 +00:00
aaron closed this issue 2026-11-16 17:21:14 +00:00
Sign in to join this conversation.
No description provided.