Skip to main content

​
Requirements

  • A systemd-based Linux distribution — Ubuntu/Debian, RHEL/CentOS/Fedora, or equivalent
  • x86_64 or arm64
  • Claude Code installed
  • Root/sudo access (for installation)

​
Install

Generate a registration key from Agent Settings > Registration Keys in your Turen dashboard before starting, then export it so the installer can pick it up: 
export TUREN_REGISTRATION_KEY=rk_live_xxx
Pick one of the install paths below. Picks the right tarball for your architecture, verifies the SHA256 checksum, writes binaries to /usr/local/bin, and wires up a systemd service: 
curl -sSL https://downloads.turen.io/install.sh | sudo -E sh

​
Option 2: .deb (Ubuntu/Debian)

Download the .deb for your architecture from the Downloads section of the dashboard, then: 
sudo -E dpkg -i turen-agent_*.deb

​
Option 3: .rpm (RHEL/CentOS/Fedora)

Download the .rpm for your architecture from the dashboard, then: 
sudo -E rpm -i turen-agent-*.rpm
Every install path will:
  • Install turen-watchdog, turen-proxy, turen-pkg, and turen-batou to /usr/local/bin
  • Register the machine with your Turen organization
  • Configure Claude Code automatically (environment variables and hooks)
  • Start the agent as a systemd service (turen-watchdog.service) that runs on boot
Once installed, open a new terminal and use Claude Code as normal: 
claude
No manual configuration is needed.

​
Managing the Agent

# Check agent status
turen-watchdog status

# Stop the agent
sudo systemctl stop turen-watchdog

# Start the agent
sudo systemctl start turen-watchdog

# View agent logs
sudo journalctl -u turen-watchdog -n 200

​
Uninstall

# Ubuntu/Debian
sudo dpkg -r turen-agent

# RHEL/CentOS/Fedora
sudo rpm -e turen-agent
If you installed with install.sh, remove the agent the same way you would a package from your distro — or stop the service, delete /usr/local/bin/turen-*, and remove /etc/systemd/system/turen-watchdog.service.

​
Other Platforms

Windows support is coming soon. Contact us at support@turen.io if you need early access.