> ## Documentation Index
> Fetch the complete documentation index at: https://docs.turen.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux

> Install Turen on Linux

## Requirements

* A systemd-based Linux distribution: Ubuntu/Debian, RHEL/CentOS/Fedora, or equivalent
* x86\_64 or arm64
* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
* Root/sudo access (for installation)

## Install

Generate a registration key from **Agent Settings > Registration Keys** in your [Turen dashboard](https://dashboard.turen.io) before starting, then export it so the installer can pick it up:

```bash theme={null}
export TUREN_REGISTRATION_KEY=rk_live_xxx
```

Pick one of the install paths below.

### Option 1: One-line installer (recommended)

Picks the right tarball for your architecture, verifies the SHA256 checksum, writes binaries to `/usr/local/bin`, and wires up a systemd service:

```bash theme={null}
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:

```bash theme={null}
sudo -E dpkg -i turen-agent_*.deb
```

### Option 3: `.rpm` (RHEL/CentOS/Fedora)

Download the `.rpm` for your architecture from the dashboard, then:

```bash theme={null}
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:

```bash theme={null}
claude
```

No manual configuration is needed.

## Managing the Agent

```bash theme={null}
# 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

```bash theme={null}
# 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

Running Turen on macOS or Windows? See the [macOS](/installation/macos) or [Windows](/installation/windows) installation guides.