v0.4.5

What's new in v0.4.5

Release packaging

• macOS Apple Silicon — publish *-darwin-arm64.tar.gz (+ .sha256) for threescale-export, threescale-seed, and threescale-visualize alongside existing *-linux-amd64.tar.gz assets
• Docs — downloads labeled by OS/arch; native Mac CLI still needs qemu/binfmt for the Red Hat linux/amd64 toolbox image

See README and CHANGELOG.md for flags and full release history.

---

Download

Assets are labeled by OS and architecture:

Platform	Archive suffix
Linux amd64	*-linux-amd64.tar.gz
macOS Apple Silicon (darwin/arm64)	*-darwin-arm64.tar.gz

A native macOS CLI binary does not remove the need for a linux/amd64 Red Hat toolbox image under qemu/binfmt (Docker Desktop or Podman machine) when using the containerized toolbox path.

1. Export a tenant (with metrics)

Linux amd64 (primary):

tar xzf threescale-export-v0.4.5-linux-amd64.tar.gz
chmod +x threescale-export

export THREESCALE_ADMIN_URL="https://tenant-admin.example.com"
export THREESCALE_ACCESS_TOKEN="your-token"

./threescale-export \
  --output ./export \
  --include-applications \
  --include-metrics \
  --metrics-since 2026-01-01 \
  --metrics-until 2026-01-31 \
  --redact-secrets \
  --insecure

macOS Apple Silicon (darwin-arm64):

tar xzf threescale-export-v0.4.5-darwin-arm64.tar.gz
chmod +x threescale-export
# Same export flags as above. Toolbox still needs AMD64 emulation
# (Docker Desktop / Podman machine qemu/binfmt) for the Red Hat image.

Metrics only:

./threescale-export metrics \
  --output ./export \
  --metrics-since 2026-01-01 \
  --metrics-until 2026-01-31

2. Visualize (optional)

tar xzf threescale-visualize-v0.4.5-linux-amd64.tar.gz
chmod +x threescale-visualize

./threescale-visualize ./export -o ./report
./threescale-visualize ./export -o ./report --html

On Apple Silicon, use threescale-visualize-v0.4.5-darwin-arm64.tar.gz instead.

Full guide: docs/VISUALIZE.md.

Lab / demo (optional)

• threescale-seed-v0.4.5-linux-amd64.tar.gz — docs/SEED.md (also *-darwin-arm64.tar.gz on Apple Silicon)
• export-minimal-1.0.tar.gz — offline fixture
• Demo HTML: docs/examples/topology-demo.html

Verification

# After downloading the archive(s) for your platform:
sha256sum -c threescale-export-v0.4.5-linux-amd64.tar.gz.sha256
sha256sum -c threescale-visualize-v0.4.5-linux-amd64.tar.gz.sha256
# Apple Silicon:
# sha256sum -c threescale-export-v0.4.5-darwin-arm64.tar.gz.sha256
# sha256sum -c threescale-visualize-v0.4.5-darwin-arm64.tar.gz.sha256

What's Changed

• Update README.md by @pcastelo in #64
• ci(release): publish darwin/arm64 assets and document Apple Silicon by @fmenesesg in #66
• chore(release): v0.4.5 CHANGELOG and release notes by @fmenesesg in #67

Full Changelog: v0.4.4...v0.4.5