Overview

The Tenzir package includes two binaries:

• tenzir: Execute a single pipeline from the command line
• tenzir-node: Run a persistent node for continuous pipeline execution

These binaries run pipelines on your machine. To manage pipelines through a web interface, create an account and use the platform. See the architecture overview to learn how they fit together.

Supported Platforms

Tenzir runs on macOS (Apple Silicon) and Linux (x86_64, ARM64).

Choose the installation method that fits your use case.

uvx

Run pipelines instantly without installation:

uvx tenzir 'from {x: 42}'

Use uvx tenzir@latest to ensure you always get the most recent release. If startup time is a concern, omit @latest and manually refresh the cache when you want updates.

curl installer

Run the installer and follow the instructions to download the binaries, and optionally start a node:

curl https://get.tenzir.app | sh

The installer script asks for confirmation before performing the installation. It uses the package manager of your Linux distribution to install the Tenzir package. This typically also creates a systemd unit and starts the node automatically.

Packages

Debian

1. Download the latest Debian package (arm64 version).

2. Install it via dpkg:

   dpkg -i tenzir_latest_arm64.deb

To uninstall, run apt-get remove tenzir. Use purge instead of remove to also delete the state directory.

RPM-based

1. Download the latest [RPM package][tenzir-rpm-package] (aarch64 version).

2. Install it via rpm:

   rpm -i tenzir-latest-x86_64-linux-static.rpm

Nix

Run Tenzir ad-hoc without installing:

nix --accept-flake-config run github:tenzir/tenzir/latest 'from {x: 42}'

Or enter a shell with Tenzir available:

nix --accept-flake-config shell github:tenzir/tenzir/latest -c $SHELL

Install a Tenzir Node by adding github:tenzir/tenzir/latest to your flake inputs, or use your preferred method to include third-party modules on classic NixOS.

Pre-built only!

The default attributes of the flake contain some closed source plugins and will fail to download locally. The flake is only for public consumption together with the Tenzir cachix cache.

Docker

Run pipelines in a container without installing anything locally:

docker run --rm -it tenzir/tenzir 'from {x: 42}'

Tarball

1. Download the [static binary tarball][tenzir-tarball].

2. Unpack it into /opt/tenzir:

   tar xzf tenzir-latest-x86_64-linux-static.tar.gz -C /

We also offer [prebuilt binaries for every commit to main][tenzir-tarball-main] (aarch64 version).

Build from source

You can also build from source. Note that this excludes proprietary plugins that ship with our prebuilt packages.

Next steps

• Run pipelines: Execute TQL pipelines from the CLI
• Deploy a node: Run a persistent node for continuous operation
• Configuration: Learn how to configure Tenzir with files and environment variables