Skip to content

macOS

Install the Runtime flavor of the 10x Engine via Homebrew. The formula includes the native binary, pipeline modules, configuration files, and pre-compiled symbol libraries.

Flavors available on macOS

macOS has an artifact for all three flavors, on both Intel and Apple silicon:

Flavor Artifact How to install
Runtime native binary brew install log-10x/tap/log10x (below), or the single line installer
Compiler .dmg brew install --cask log-10x/tap/log10x-cloud (below)
Runtime (JVM) .dmg tenx-edge-<ver>.dmg (Apple silicon) or tenx-edge-<ver>-intel.dmg from the releases page

The native Runtime is the flavor to use on macOS. Runtime (JVM) exists for hosts where the native binary will not run; on Windows, which has no native build, it is the only runtime.

Install

brew trust log-10x/tap
brew install log-10x/tap/log10x

The tenx command is available immediately.

Why brew trust

Homebrew 6.0.14 and later refuse to load a formula from a third-party tap until the tap is trusted, so brew install alone fails with:

Error: Refusing to load formula log-10x/tap/log10x from untrusted tap log-10x/tap.

Older Homebrew versions do not need the first command, and running it there is harmless.

Upgrading from an install made before March 2026

log10x used to be the name of the cask that installs the Cloud desktop app. That cask is now log10x-cloud, and log10x is the formula that installs the tenx CLI.

If you installed the old cask before the rename, Homebrew still treats it as the owner of the log10x name and declines to link the formula:

==> log10x cask is installed, skipping link.
Removing: /usr/local/Cellar/log10x/1.0.21...

The upgrade reports success, and tenx is then missing from your PATH. Restore it with:

brew link --overwrite log10x

Verify with tenx --version. To clear the cause rather than the symptom, remove the superseded cask: brew uninstall --cask log10x.

Fresh installs are not affected.

What's included

The formula installs:

Component Location
tenx-edge native binary $(brew --prefix)/libexec/tenx-edge
tenx CLI wrapper $(brew --prefix)/bin/tenx
Pipeline modules $(brew --prefix)/lib/tenx/modules
Configuration files $(brew --prefix)/etc/tenx/config
Symbol libraries $(brew --prefix)/etc/tenx/symbols

Configuration

The tenx wrapper sets default paths automatically. To override, set these environment variables:

Variable Default Description
TENX_CONFIG $(brew --prefix)/etc/tenx/config Path to configuration directory
TENX_SYMBOLS_PATH $(brew --prefix)/etc/tenx/symbols Path to symbol libraries
TENX_MODULES $(brew --prefix)/lib/tenx/modules Path to pipeline modules

See path configuration for details.

Compiler flavor

To install the Compiler flavor (required for symbol library compilation and cloud applications):

brew install --cask log-10x/tap/log10x-cloud

Update

brew upgrade log10x

Uninstall

brew uninstall log10x