Docs
amfelt download
Download the amfelt binary for the current OS and architecture from the Amfelt API, verify its SHA256 checksum against the server- supplied X-Checksum header, and write it atomically to disk.
The target path defaults to the directory of the currently-running
binary; override with --target. The default version is “latest”.
Uses --api-url, else the api-endpoint setting in the agent’s own
config.yaml or $AMFELT_API_ENDPOINT, else the endpoint register
remembered beside the identity. It never falls back to the built-in default:
this command fetches an executable and writes it to disk, so it never
guesses which host to fetch it from. --verify-only is
the exception — it hashes the binary already present and never asks the
network anything.
Examples:
# Download the latest agent from the endpoint it registered with
amfelt download # Download a specific version into /usr/local/bin, endpoint as a flag
amfelt download --api-url "$AMFELT_API_ENDPOINT" --version 5.0.0 --target /usr/local/bin/amfelt # Print the sha256 of the current binary (do not download; no endpoint needed)
amfelt download --verify-onlyUsage
amfelt download [flags]Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--api-url | string | — | API base URL — overrides $AMFELT_API_ENDPOINT, api-endpoint in the config file and the endpoint remembered at registration |
--no-verify | bool | false | Skip SHA256 verification of the download (not recommended) |
--target | string | — | Destination path (default: same directory as the running binary) |
--verify-only | bool | false | Print the SHA256 of the current binary and exit — no download |
--version | string | latest | Release version to download (e.g., ’latest’ or ‘4.3.0’) |
Global flags
| Flag | Type | Default | Description |
|---|---|---|---|
--amfelt-dir | string | .amfelt | directory for workspace files (such as plugins); does not move agent identity (controlled by AMFELT_DIR) |
--config | string | — | directory or filename of the application configuration |
-f, --format | string | default | log format to use; either default, pretty, or json |
-l, --level | string | info | minimum log level to display; either error, warn, info, or debug |
-v, --verbose | bool | false | trigger to use verbose logging |
Generated from amfelt v5.6.3.
Last updated on November 1, 2026