Skip to main content

Install Mecatl

Install the mecatui terminal client and mecated server using one of the following methods.

Homebrew​

The mecatl formula in Stacklok's tap installs both executables. It supports macOS on Apple silicon and Intel, and Linux on x86_64 and arm64. Windows users can install WSL and run the Linux formula from the WSL shell.

brew install stacklok/tap/mecatl
mecatui --version
mecated --version

Both commands should print the installed release tag, such as v0.1.0.

Upgrade, pin, or uninstall the formula:

brew update && brew upgrade mecatl
brew pin mecatl
brew uninstall mecatl

Homebrew links the executables into $(brew --prefix)/bin. For an absolute path, use $(brew --prefix mecatl)/bin/mecatui or $(brew --prefix mecatl)/bin/mecated.

Release archives​

GitHub releases provide darwin and linux archives for amd64 and arm64. Each release also includes checksums, Cosign signature bundles, SBOMs, and build provenance.

tar -xzf mecatl_<VERSION>_darwin_arm64.tar.gz
./mecatui --version

Each archive contains both executables at its root, plus the license and README.

Verify the checksum, signature, and provenance:

shasum -a 256 -c checksums.txt --ignore-missing

cosign verify-blob \
  --bundle mecatl_<VERSION>_darwin_arm64.tar.gz.sigstore.json \
  --certificate-identity-regexp '^https://github.com/stacklok/mecatl/' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  mecatl_<VERSION>_darwin_arm64.tar.gz

gh attestation verify mecatl_<VERSION>_darwin_arm64.tar.gz --repo stacklok/mecatl

The Cosign command verifies that a GitHub Actions workflow in the stacklok/mecatl repository signed the archive.

Container images​

Releases also publish signed container images to GHCR. See the mecatui container image for the importable client image and Run mecated standalone for server operation. Cloud-native Kubernetes with mecak8s covers the Kubernetes runtime, which is image-only and not part of the formula.

Build from source​

A source build requires Go 1.26.6 or later and Task v3. Run the build from the repository root.

Build all executables into bin/:

task build

Run an executable from bin/. To install mecatui and mecated into GOBIN or GOPATH/bin, run task install.

Next steps​