Linux

We offer a native deployment on various Linux distributions. Follow the instructions below to deploy a node on Linux.

Install a node

Second, choose the Linux tab and proceed as follows:

Download the config for your node.
Create a directory for the platform configuration.
Terminal window
```
mkdir -p /opt/tenzir/etc/tenzir/plugin
```
Move the downloaded platform.yaml configuration file to the directory so that the node can find it during startup:
Terminal window
```
mv platform.yaml /opt/tenzir/etc/tenzir/plugin
```
Run the installer and follow the instructions to download and start the node:
Terminal window
```
curl https://get.tenzir.app | sh
```

The installer script asks for confirmation before performing the installation. If you prefer a manual installation you can also perform the installer steps yourself. See the configuration files documentation for details on how the node loads config files at startup.

Download the latest Debian package and install it via dpkg:

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

You can uninstall the Tenzir package via apt-get remove tenzir. Use purge instead of remove if you also want to delete the state directory and leave no trace.

Download the latest RPM package and install it via rpm:

rpm -i tenzir-static-amd64-linux.rpm

Use our flake.nix:

nix run github:tenzir/tenzir/stable

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

Download a tarball with our static binary for all Linux distributions and unpack it into /opt/tenzir:

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

We also offer prebuilt statically linked binaries for every Git commit to the main branch.

curl -O https://storage.googleapis.com/tenzir-dist-public/packages/main/tarball/tenzir-static-main.gz

Start a node manually

The installer script 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.

For testing, development, our troubleshooting, run the tenzir-node executable to start a node manually:

tenzir-node

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

          v4.0.0-rc6-0-gf193b51f1f
Visit https://app.tenzir.com to get started.

[16:50:26.741] node listens for node-to-node connections on tcp://127.0.0.1:5158
[16:50:26.982] node connected to platform via wss://ws.tenzir.app:443/production

Stop a node

There exist two ways stop a server:

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

Hitting CTRL+C is equivalent to manually sending a SIGTERM signal.