fah-beta-mgr
Grid
Published: 2025-12-11

fah-beta-mgr is a bash script which manages FAH beta binaries, so you don’t have to. It does (presently) assume that it’s running in a systemd-flavored Linux distro.

Here’s what it does:

  • Maintains an A/B setup of fah-client binaries, which can be switched between
    • So if a new beta is problematic, a single command will restart FAH with the previous version
  • Checks for new beta releases of fah-client
  • If one exists, it is downloaded and becomes the ‘A’ fah-client binary
    • The previous ‘A’ binary becomes the rollback/‘B’ binary
    • Unless the ‘B’ binary was already active, in which case it is retained
  • The script can self-update (upon request) over the net

Getting started

  • Download the script here
  • As root, run /path/to/fah-beta-mgr setup
    • This will move the script to /usr/local/bin and do other setup tasks
  • Run fah-beta-mgr update to fetch the current beta FAH client and make it the active binary
    • Repeat this whenever you want to check for a new beta
  • See fah-beta-mgr help for more options

Release notes

v0.5.0 (2025-12-11)

  • ‘status’ command fixes
  • Beta version check no longer touches disk
  • Function fbm_cleanup removed
  • More documentation

v0.4.0 (2025-12-10)

  • Script self-updating enabled
  • Parameterized URLs
  • Small fixups and tweaks
  • Improved documentation
  • Add sha512sum as a prerequisite

v0.3.1

  • Groundwork for self-update
  • Small fixes

v0.3.0

  • Lower FAH bandwidth usage by using the beta releases metadata file instead of downloading a release tarball
  • Switch to A/B nomenclature
  • Retain B binary when active
  • Add jq as a prerequisite

v0.2.0

  • Initial internal testing version