v0.4.6

What's new in v0.4.6

threescale-export

• --toolbox-platform / THREESCALE_TOOLBOX_PLATFORM — opt-in --platform on toolbox podman|docker run (e.g. linux/amd64 on Apple Silicon). Empty omits the flag (no auto-default). Ignored with --toolbox-binary.

Release packaging

• macOS Apple Silicon — *-darwin-arm64.tar.gz (+ .sha256) alongside *-linux-amd64.tar.gz (since v0.4.5)

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.6-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.6-darwin-arm64.tar.gz
chmod +x threescale-export
# Same export flags as above. Prefer:
#   --toolbox-platform linux/amd64
# when using the containerized Red Hat toolbox under qemu/binfmt
# (Docker Desktop / Podman machine).

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.6-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.6-darwin-arm64.tar.gz instead.

Full guide: docs/VISUALIZE.md.

Lab / demo (optional)

• threescale-seed-v0.4.6-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.6-linux-amd64.tar.gz.sha256
sha256sum -c threescale-visualize-v0.4.6-linux-amd64.tar.gz.sha256
# Apple Silicon:
# sha256sum -c threescale-export-v0.4.6-darwin-arm64.tar.gz.sha256
# sha256sum -c threescale-visualize-v0.4.6-darwin-arm64.tar.gz.sha256

What's Changed

• feat(export): add --toolbox-platform for container run by @fmenesesg in #68
• chore(release): v0.4.6 CHANGELOG and release notes by @fmenesesg in #69

Full Changelog: v0.4.5...v0.4.6