#!/usr/bin/env bash # Hangar: the game server panel. One line installs everything: # # curl -fsSL https://api.mintmotive.com.au/hangar/install.sh | sudo bash # # It works on Ubuntu, Debian, Raspberry Pi OS, Linux Mint, Pop!_OS, Fedora, Rocky/Alma, Arch and openSUSE, # 64-bit Intel/AMD or ARM (a Raspberry Pi 4 or 5 is fine). It installs what Hangar needs (Docker, Node.js, # unpackers), downloads Hangar and checks it against its published fingerprint, sets it up as a service that # starts with the machine, finds the game servers already here, and updates itself each night (keeping the # previous version, and going back to it if the new one doesn't start). # # Running it again updates Hangar. Nothing you've set up is touched. # From the mint-cloud folder it installs that copy instead: sudo ./apps/hangar/install.sh # # Options (put them before bash: curl … | sudo HANGAR_PORT=9000 bash): # HANGAR_PORT=8800 the panel's port # HANGAR_HOST=0.0.0.0 who can reach it: 0.0.0.0 (your network) or 127.0.0.1 (this machine, plus Tailscale if it's here) # HANGAR_DATA, HANGAR_SERVERS where Hangar keeps its own files and the game servers # HANGAR_USER=you the account Hangar runs as (default: whoever ran sudo, or a new "hangar" account) # HANGAR_AUTO_UPDATE=0 don't update by itself each night # HANGAR_VERSION=1.4.0 install that version instead of the newest # HANGAR_ADOPT="acserver" systemd services Hangar may always start and stop (game servers it finds are added too) # HANGAR_LICENCE_KEY=HANGAR-… a licence key for Hangar to use on its first start # HANGAR_SETUP_CODE=XXXX-… the code for making the owner account (otherwise one is made) # HANGAR_HOSTED=1 a server we host: Hangar sits behind HTTPS on https://
.sslip.io set -euo pipefail GIVEN_SITE=${HANGAR_SITE:-} SITE=${GIVEN_SITE:-https://api.mintmotive.com.au/hangar} OPT=${HANGAR_OPT:-/opt/hangar} QUIET=${HANGAR_QUIET:-0} if [ -t 1 ]; then B=$'\e[1m'; G=$'\e[32m'; Y=$'\e[33m'; R=$'\e[31m'; D=$'\e[2m'; N=$'\e[0m'; else B='' G='' Y='' R='' D='' N=''; fi say() { [ "$QUIET" = 1 ] || printf '%s▸%s %s\n' "$G" "$N" "$*"; } note() { [ "$QUIET" = 1 ] || printf ' %s%s%s\n' "$D" "$*" "$N"; } warn() { printf '%s!%s %s\n' "$Y" "$N" "$*"; } die() { printf '%s✕ %s%s\n' "$R" "$*" "$N" >&2; exit 1; } trap 'die "The install stopped at line $LINENO. Anything that was already running hasn’t been changed. Run it again, or send this output to support."' ERR [ "$(id -u)" = 0 ] || die "Run it with sudo: curl -fsSL $SITE/install.sh | sudo bash" [ -d /run/systemd/system ] || die "Hangar needs a Linux machine that uses systemd (most do: Ubuntu, Debian, Raspberry Pi OS, Fedora…)." [ "$QUIET" = 1 ] || printf '\n%sHANGAR%s %sgame server panel%s\n\n' "$B" "$N" "$D" "$N" # ---------------------------------------------------------------- this machine . /etc/os-release 2>/dev/null || true if command -v apt-get >/dev/null; then PM=apt; elif command -v dnf >/dev/null; then PM=dnf; elif command -v yum >/dev/null; then PM=yum; elif command -v pacman >/dev/null; then PM=pacman; elif command -v zypper >/dev/null; then PM=zypper; else die "Hangar doesn't know how to install software on ${PRETTY_NAME:-this system} yet."; fi case "$(uname -m)" in x86_64|amd64) ARCH=x64 ;; aarch64|arm64) ARCH=arm64 ;; armv7l) ARCH=armv7l; warn "32-bit ARM works, but a 64-bit system runs game servers much better." ;; *) die "Hangar runs on 64-bit Intel/AMD or ARM machines; this is $(uname -m)." ;; esac note "${PRETTY_NAME:-Linux} on $(uname -m)" pkg() { case "$PM" in apt) DEBIAN_FRONTEND=noninteractive apt-get install -y -qq "$@" >/dev/null ;; dnf|yum) "$PM" install -y -q "$@" >/dev/null ;; pacman) pacman -Sy --noconfirm --needed "$@" >/dev/null ;; zypper) zypper -q -n install "$@" >/dev/null ;; esac } say "Getting the basics (downloads, unpackers)" case "$PM" in apt) apt-get update -qq >/dev/null || true; pkg ca-certificates curl tar xz-utils unzip libarchive-tools sudo git ;; dnf|yum) pkg ca-certificates curl tar xz unzip bsdtar sudo git ;; pacman) pkg ca-certificates curl tar xz unzip libarchive sudo git ;; zypper) pkg ca-certificates curl tar xz unzip bsdtar sudo git ;; esac # ---------------------------------------------------------------- the account Hangar runs as, and where things live # An update keeps every setting: what's in /etc/hangar.env wins over the defaults (options given now win over both). for k in HANGAR_DATA HANGAR_SERVERS HANGAR_PORT HANGAR_HOST HANGAR_AUTO_UPDATE; do eval "GIVEN_$k=\${$k:-}"; done GIVEN_USER=${HANGAR_USER:-} [ -f /etc/hangar.env ] && . /etc/hangar.env SITE=${GIVEN_SITE:-${HANGAR_SITE:-$SITE}} for k in HANGAR_DATA HANGAR_SERVERS HANGAR_PORT HANGAR_HOST HANGAR_AUTO_UPDATE; do eval "v=\$GIVEN_$k"; [ -n "$v" ] && eval "$k=\$v"; done RUN_AS=${GIVEN_USER:-${HANGAR_RUN_AS:-${SUDO_USER:-}}} if [ -z "$RUN_AS" ] || [ "$RUN_AS" = root ]; then RUN_AS=hangar if ! id hangar >/dev/null 2>&1; then say "Making an account for Hangar to run as (hangar)"; useradd --system --create-home --home-dir /var/lib/hangar --shell /usr/sbin/nologin hangar; fi fi id "$RUN_AS" >/dev/null 2>&1 || die "There's no account called $RUN_AS." HOME_DIR=$(getent passwd "$RUN_AS" | cut -d: -f6) if [ -d /srv/mint-data ]; then DEF_DATA=/srv/mint-data/hangar; DEF_SERVERS=/srv/mint-data/hangar-servers; else DEF_DATA=$HOME_DIR/hangar-data; DEF_SERVERS=$HOME_DIR/hangar-servers; fi DATA=${HANGAR_DATA:-$DEF_DATA} SERVERS=${HANGAR_SERVERS:-$DEF_SERVERS} PORT=${HANGAR_PORT:-8800} ADOPT=${HANGAR_ADOPT:-"acserver acserver@*"} AUTO=${HANGAR_AUTO_UPDATE:-1} HOSTED=${HANGAR_HOSTED:-0} if [ "$HOSTED" = 1 ]; then HANGAR_HOST=127.0.0.1; fi if [ -z "${HANGAR_HOST:-}" ]; then # With Tailscale here, the panel stays on this machine and Tailscale carries it (with HTTPS). Otherwise it's # open on your network, and protected by the setup code until you've made your account. if command -v tailscale >/dev/null && tailscale status >/dev/null 2>&1; then HOST=127.0.0.1; else HOST=0.0.0.0; fi else HOST=$HANGAR_HOST; fi # ---------------------------------------------------------------- Docker: every game runs in its own container if ! command -v docker >/dev/null; then say "Installing Docker" case "$PM" in apt) pkg docker.io || curl -fsSL https://get.docker.com | sh >/dev/null ;; dnf|yum) pkg moby-engine 2>/dev/null || pkg docker 2>/dev/null || curl -fsSL https://get.docker.com | sh >/dev/null ;; pacman|zypper) pkg docker ;; esac fi systemctl enable --now docker >/dev/null 2>&1 || true docker info >/dev/null 2>&1 || die "Docker is installed but isn't running. Try: sudo systemctl start docker, then run this again." note "$(docker --version)" # ---------------------------------------------------------------- Node.js 22 (Hangar's own copy, if the system's is older) NODE="" if command -v node >/dev/null && [ "$(node -p 'process.versions.node.split(".")[0]' 2>/dev/null || echo 0)" -ge 22 ]; then NODE=$(command -v node) elif [ -x "$OPT/node/bin/node" ] && [ "$("$OPT/node/bin/node" -p 'process.versions.node.split(".")[0]')" -ge 22 ]; then NODE=$OPT/node/bin/node else say "Getting Node.js 22 for Hangar (its own copy, in $OPT/node)" TMPN=$(mktemp -d) curl -fsSL https://nodejs.org/dist/latest-v22.x/SHASUMS256.txt -o "$TMPN/SUMS" FILE=$(grep -oE "node-v22\.[0-9]+\.[0-9]+-linux-$ARCH\.tar\.xz" "$TMPN/SUMS" | head -1) [ -n "$FILE" ] || die "Couldn't find Node.js 22 for $ARCH." curl -fsSL "https://nodejs.org/dist/latest-v22.x/$FILE" -o "$TMPN/$FILE" (cd "$TMPN" && grep " $FILE\$" SUMS | sha256sum -c --quiet -) || die "Node.js didn't match its published fingerprint, so it wasn't installed." rm -rf "$OPT/node" && mkdir -p "$OPT/node" && tar -xJf "$TMPN/$FILE" -C "$OPT/node" --strip-components=1 --no-same-owner rm -rf "$TMPN"; NODE=$OPT/node/bin/node fi note "Node.js $("$NODE" -v)" # ---------------------------------------------------------------- Hangar itself SRC=""; SELF="${BASH_SOURCE[0]:-}" if [ -n "$SELF" ] && [ -f "$SELF" ] && [ -f "$(dirname "$SELF")/lib/app.js" ] && [ "${HANGAR_FROM_SITE:-0}" != 1 ]; then SRC=$(cd "$(dirname "$SELF")" && pwd); fi mkdir -p "$OPT/releases" if [ -n "$SRC" ]; then VERSION=$("$NODE" -p "require('$SRC/package.json').version") say "Installing Hangar $VERSION from $SRC" DEST="$OPT/releases/$VERSION"; rm -rf "$DEST.new"; mkdir -p "$DEST.new/bin" cp -r "$SRC/lib" "$SRC/public" "$SRC/server.js" "$SRC/package.json" "$SRC/install.sh" "$DEST.new/" cp "$SRC/bin/hangar" "$DEST.new/bin/hangar" CHANNEL=local else TMPH=$(mktemp -d) curl -fsSL "$SITE/latest.json" -o "$TMPH/latest.json" || die "Couldn't reach $SITE. Is this machine online?" read -r VERSION TARBALL SHA <<<"$("$NODE" -e ' const j = require(process.argv[1]); const want = process.argv[2]; const r = !want || j.version === want ? j : (j.releases || []).find((x) => x.version === want); if (!r) { process.exit(1); } console.log(r.version, r.tarball, r.sha256);' "$TMPH/latest.json" "${HANGAR_VERSION:-}")" || die "Hangar ${HANGAR_VERSION:-} isn't on $SITE." say "Downloading Hangar $VERSION" curl -fsSL "$SITE/$TARBALL" -o "$TMPH/$TARBALL" echo "$SHA $TMPH/$TARBALL" | sha256sum -c --quiet - || die "The download didn't match Hangar's published fingerprint, so nothing was changed." note "Fingerprint checked: ${SHA:0:16}…" DEST="$OPT/releases/$VERSION"; rm -rf "$DEST.new"; mkdir -p "$DEST.new" tar -xzf "$TMPH/$TARBALL" -C "$DEST.new" --strip-components=1 --no-same-owner rm -rf "$TMPH" CHANNEL=site fi [ -f "$DEST.new/server.js" ] && [ -f "$DEST.new/bin/hangar" ] || die "That copy of Hangar is incomplete." chown -R root:root "$DEST.new"; chmod -R go-w "$DEST.new" PREV=$(readlink -f "$OPT/current" 2>/dev/null || true) [ "$PREV" = "$DEST" ] && PREV="" rm -rf "$DEST" && mv "$DEST.new" "$DEST" ln -sfn "$DEST" "$OPT/current" # the layout from before releases/ (lib, public… straight in /opt/hangar) goes rm -rf "$OPT/lib" "$OPT/public" "$OPT/server.js" "$OPT/package.json" # keep this version and the two before it ls -1t "$OPT/releases" | grep -v '\.new$' | tail -n +4 | while read -r old; do [ "$OPT/releases/$old" = "$PREV" ] || rm -rf "${OPT:?}/releases/$old"; done # ---------------------------------------------------------------- folders, settings usermod -aG docker "$RUN_AS" if getent group systemd-journal >/dev/null; then usermod -aG systemd-journal "$RUN_AS"; fi mkdir -p "$DATA" "$SERVERS" && chown "$RUN_AS:$RUN_AS" "$DATA" "$SERVERS" cat > /etc/hangar.env <