Skip to main content
Version: Tenzir v4.6

Deploy a node

A node is a managed service for pipelines and storage.

Install a node

Choose between Docker, Linux, and macOS installation instructions.


Visit the configurator to download a docker-compose.NODE.yaml configuration file where NODE is the name you entered for your node. Then run:

docker compose -f docker-compose.NODE.yaml up --detach

Set environment variables to adjust the configuration.


Use our installer to install a binary package on any Linux distribution:

curl | sh

The shell script asks for confirmation before performing the installation. If you prefer a manual installation you can also perform the installer steps yourself.

Download the latest Debian package and install it via dpkg:

dpkg -i tenzir-static-amd64-linux.deb


Please use Docker with Rosetta until we offer a native package.

Start a node

Implicit start with Docker

You can skip this step if you use Docker because docker compose up already starts a node for you.

Run the tenzir-node executable to start a node:

      _____ _____ _   _ ________ ____
|_ _| ____| \ | |__ /_ _| _ \
| | | _| | \| | / / | || |_) |
| | | |___| |\ |/ /_ | || _ <
|_| |_____|_| \_/____|___|_| \_\

Visit to get started.

This will spawn a blocking process that listens by default on the TCP endpoint Select a different endpoint via --endpoint, e.g., bind to an IPv6 address:

tenzir-node --endpoint=[::1]:42000
Unsafe Pipelines

Some pipeline operators are inherently unsafe due to their side effects, e.g., reading from a file. When such operators run inside a node, you may involuntarily expose the file system to users that have access to the node, or when you connect the node to the Tenzir platform and manage it via This may constitute a security risk.

We therefore forbid pipelines with such side effects by default. If you are aware of the implications, you can remove this restriction by setting tenzir.allow-unsafe-pipelines: true in the tenzir.yaml of the respective node.

Stop a node

There exist two ways stop a server:

  1. Hit CTRL+C in the same TTY where you ran tenzir-node.
  2. Send the process a SIGINT or SIGTERM signal, e.g., via pkill -2 tenzir-node.

Sending the process a SIGTERM is the same as hitting CTRL+C.

Automate the deployment

Read our guides on automating the deployment of a node: