AhanaWire 3.0.6 install (Linux x86-64, Docker) AhanaWire © 2026 AhanaAI. Patent Pending. All rights reserved. Install an AhanaWire site (a compress edge, an expand edge and the local command center) on one Linux x86-64 host with Docker. The same steps work for a person and for an AI agent. Rules (the key is the only secret): - The API key is the only secret. Never paste it into a chat, a ticket, a command line or a shell history. - An AI agent never asks the user to type or paste the key into the conversation. The user puts it in the key file, or it is already in the environment as AHANAWIRE_API_KEY. - Never print, echo, log or copy the key. install.sh reads it and never prints it. - The key file must be readable only by its owner (mode 600). - Verify the sha256 and the signature before running anything from the download. Inputs: - AHANAWIRE_API_KEY [secret]: Either the environment variable AHANAWIRE_API_KEY, or a file holding only the key (default $HOME/.ahanawire-key, mode 600). Set AHANAWIRE_API_KEY_FILE if the file lives elsewhere. - AHANAWIRE_API_KEY_FILE (default $HOME/.ahanawire-key): Path of the key file. It must be mode 600. - AHANAWIRE_HOME (default $HOME/ahanawire): Where releases, state and logs are kept. - AHANAWIRE_COMPRESS_PORT (default 19752): Local port of the compress edge (bound to 127.0.0.1). - AHANAWIRE_EXPAND_PORT (default 19754): Local port of the expand edge (bound to 127.0.0.1). - AHANAWIRE_RELEASES (default https://ahanaai.com/ahanawire/releases): Release download location. Change it only for a mirror you trust. - AHANAWIRE_CENTER_PORT (default 19770): Local port of the command center page (bound to 127.0.0.1). Run install.sh --no-center to leave the command center out. - AHANAWIRE_NO_OPEN (default 0): When an install or update finishes in a terminal on a desktop (not as root, over SSH, in CI or with --json), install.sh opens the command center page in your browser. Set to 1, or run install.sh --no-open, to skip that. The address is always printed. Requirements: - Linux x86-64 host - Docker Engine with the compose plugin (docker compose) - curl, sha256sum, tar, cmp, bash - minisign, or Docker to run the pinned minisign image Run each $ line in one terminal, in order. Every line must succeed (exit code 0) unless a success line under it says otherwise. Step 1. Check the requirements $ docker compose version $ curl --version $ sha256sum --version Step 2. Put your API key in a private file $ touch "$HOME/.ahanawire-key" && chmod 600 "$HOME/.ahanawire-key" BY HAND: Open $HOME/.ahanawire-key in a text editor, paste the key from your AhanaWire checkout as the only line, and save. If the key is already in the environment as AHANAWIRE_API_KEY, skip this. An AI agent does not do this step: the user does it, outside the chat. $ test -s "$HOME/.ahanawire-key" || test -n "${AHANAWIRE_API_KEY:-}" Step 3. Download the release $ V=3.0.6 $ T=ahanawire-$V-linux-amd64.tar.gz $ R="${AHANAWIRE_RELEASES:-https://ahanaai.com/ahanawire/releases}/$V" $ mkdir -p "$HOME/ahanawire-download" && cd "$HOME/ahanawire-download" $ curl -fsSLO "$R/$T" && curl -fsSLO "$R/$T.sha256" && curl -fsSLO "$R/$T.minisig" Step 4. Verify the checksum and the signature $ sha256sum -c "$T.sha256" $ PUB=RWQTvTlH/J3qidyLu6hOdfA7S902A2lLg6cIsI4Xm660P3gEqchzyVPb $ if command -v minisign >/dev/null 2>&1; then minisign -Vm "$T" -P "$PUB"; else docker run --rm -v "$PWD:/w:ro" -w /w jedisct1/minisign@sha256:ee60186c5d05e342e66cbc81133aa744d026752d909d8ea021a15c4d16b1193b -Vm "$T" -P "$PUB"; fi Step 5. Install $ tar -xzf "$T" $ "./ahanawire-$V-linux-amd64/install.sh" success: exit code 0 or 2 Step 6. Check it works $ "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --check Success checks: - The compress edge answers /health on 127.0.0.1:19752 (or AHANAWIRE_COMPRESS_PORT). - The expand edge answers /health on 127.0.0.1:19754 (or AHANAWIRE_EXPAND_PORT). - Both edges report release 3.0.6 on /version. - A keyed round trip (compress, then expand) gives back identical bytes (cmp). - install.sh --check exits 0. With --json it prints ok true, every check true and reported_version 3.0.6. - The command center answers /health on 127.0.0.1:19770 (or AHANAWIRE_CENTER_PORT), unless it was left out with --no-center. Its first admin signs in with the one-time setup code in $HOME/ahanawire/center/setup-code. Exit codes of install.sh: 0 = healthy (installed, updated, rolled back, uninstalled, or the check passed) 1 = failed; the FIX line (or the fix field with --json) says what to do 2 = already in the requested state (already installed and healthy, already on that version, or already uninstalled) Manage: Open the command center (status, update, rollback, uninstall, verify, one-click restore, this install's usage): xdg-open http://127.0.0.1:19770/ || echo open http://127.0.0.1:19770/ in a browser on this machine Show the newest signed release: "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --latest Leave the command center out (or put it back with --with-center): "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --no-center Show the cache settings (location and cap of each AW Endpoint) and the drives it can use: "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --show-config Move a cache or change its cap (a new or empty folder; checks the free space, stops only that AW Endpoint, moves its cache, starts it again; the command center stays signed in): "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --set-cache --cache-dir-expand /mnt/big/ahanawire-cache --cache-max-expand 500G Choose the cache at install time (both AW Endpoints; use --cache-dir-compress / --cache-dir-expand and --cache-max-compress / --cache-max-expand for one each; default: the Docker volume, 10G cap each): ./install.sh --cache-dir /mnt/big/ahanawire-cache --cache-max 50G Stop or start one AW Endpoint (sending = compress, receiving = expand; update, rollback and repair start both again): "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --endpoint-stop expand then --endpoint-start expand Machine-readable check: "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --check --json Update to the latest release (verified with the installed key; the cache is kept): "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --update Go back to the previous release: "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --rollback Install or update from a local signed bundle (the script verifies the checksum and signature; the cache is kept): "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --bundle FILE.tar.gz Uninstall (keeps the cache and the key file): "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --uninstall --keep-cache --keep-key Uninstall and remove the cache and the key file: "${AHANAWIRE_HOME:-$HOME/ahanawire}/current/install.sh" --uninstall --remove-cache --delete-key Stop AhanaWire (keeps the cache): docker compose -p ahanawire --profile center down Cache (3.0.6): each AW Endpoint keeps its cache on this machine, in the Docker volume _cache by default, with a cap of 10 GiB each (10G, 500G, 2T or none). The command center Install tab shows where each cache lives, its drive, cap, use and free space, and lets an admin move it to another drive or change the cap. Cache folders are 0700 and files 0600. When the cache reaches its cap the oldest data is removed first. Each endpoint leaves the smaller of 5% of the drive and 1 GiB free; if the drive gets full anyway, new data is simply not cached and requests keep working. Signing key 89EA9DFC4739BD13 (minisign): RWQTvTlH/J3qidyLu6hOdfA7S902A2lLg6cIsI4Xm660P3gEqchzyVPb Agent guide: AGENTS.md and install.json in this bundle. Release feed: https://ahanaai.com/ahanawire/releases/latest.json Kubernetes: build the image from the Dockerfile in the bundle and push it to a registry your cluster can pull from (k3s/containerd cannot see a local Docker image), set the image in k8s.yaml, put your key in the Secret, then kubectl apply -f k8s.yaml. Both pods share one ReadWriteOnce claim: single node, or a ReadWriteMany storage class. The claim is 22Gi in 3.0.6: both caps (10 GiB each) plus 10%; size it to your caps and pick its disk with storageClassName.