# AhanaWire 3.0.6

> 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.

AhanaWire © 2026 AhanaAI. Patent Pending. All rights reserved.
AhanaAI · DUNS 149970889

Install steps for people and AI agents. Full guide: AGENTS.md. Machine manifest: install.json. Page: https://ahanaai.com/ahanawire/install/

## Rules

- 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: Path of the key file. It must be mode 600.
- AHANAWIRE_HOME: Where releases, state and logs are kept.
- AHANAWIRE_COMPRESS_PORT: Local port of the compress edge (bound to 127.0.0.1).
- AHANAWIRE_EXPAND_PORT: Local port of the expand edge (bound to 127.0.0.1).
- AHANAWIRE_RELEASES: Release download location. Change it only for a mirror you trust.
- AHANAWIRE_CENTER_PORT: 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: 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.

## Steps (one shell session, in order; each line must exit 0 unless noted)

1. Check the requirements
   $ docker compose version
   $ curl --version
   $ sha256sum --version
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:-}"
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"
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
5. Install
   $ tar -xzf "$T"
   $ "./ahanawire-$V-linux-amd64/install.sh"
     success: exit code 0 or 2
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

- 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)

## Optional

- [Release feed](https://ahanaai.com/ahanawire/releases/latest.json)
- [Install page](https://ahanaai.com/ahanawire/install/)
