Set up the Linux agent service

Overview

Run the zrok agent as a systemd --user service under your Linux user account.

Install the package

The zrok2 package provides the zrok2 executable. The zrok2-agent package provides the zrok2-agent.service systemd user service unit.

1. Set up zrok's Linux package repository by following the Linux install guide, or run this one-liner to complete the repo setup and install packages.

   curl -sSLf https://get.openziti.io/install.bash \
   | sudo bash -s zrok2-agent

2. If you previously set up the repository by following the guide, then also install the zrok2-agent package. This package provides the systemd service.

   Ubuntu, Debian

   sudo apt install zrok2-agent

   Fedora, Rocky

   sudo dnf install zrok2-agent

Enable your account

This creates a ~/.zrok2 directory enabled for your zrok account.

zrok2 enable <your_account_token>

Start the service

systemctl --user enable --now zrok2-agent.service

Use the agent

Learn more about using the zrok agent in the agent guide.

Troubleshooting

Check the user service log

journalctl --user -lfu zrok2-agent.service