> ## 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.

# Quickstart

> Get Turen running in under 5 minutes

## Prerequisites

* A machine running macOS 13 (Ventura) or later, or a systemd-based Linux distribution (Ubuntu/Debian, RHEL/CentOS/Fedora) on x86\_64 or arm64
* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
* A Turen account: [sign up at dashboard.turen.io](https://dashboard.turen.io)

## Step 1: Generate a Registration Key

In the Turen dashboard, go to **Settings > Registration Keys** and create a new key. You'll get a key that looks like:

```
rk_live_abc123...
```

Copy this key. You'll need it for the next step.

## Step 2: Install the Agent

On **macOS**, download the `.dmg` installer from the **Fleet** section of your [Turen dashboard](https://dashboard.turen.io), open it, and follow the installation prompts. You'll be asked to enter your registration key during installation.

<Frame>
  <img src="https://mintcdn.com/turenlabsinc/ghKr-MU50JOwlhzs/images/image-10.png?fit=max&auto=format&n=ghKr-MU50JOwlhzs&q=85&s=6f4255783b592950d46a245e66e64189" alt="Image" width="1549" height="262" data-path="images/image-10.png" />
</Frame>

On **Linux**, see the [Linux installation guide](/installation/linux) for `.deb`, `.rpm`, and one-line installer options.

The installer will:

* Install **turen-watchdog**, **turen-proxy**, **turen-pkg**, and **turen-batou**
* Register the machine with your Turen organization using your registration key
* Configure Claude Code automatically via `managed-settings.json`
* Start the agent as a background service (LaunchDaemon on macOS, systemd on Linux)

<Check>
  Registration happens automatically during installation. After setup, the agent authenticates itself; no further configuration is needed.
</Check>

## Step 3: Use Claude Code

Open a new terminal and run Claude Code as normal:

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

That's it. The installer has already configured Claude Code to route through the Turen proxy, set up environment variables, and registered hooks. All security rules are active, and sessions are being recorded.

## Step 4: Verify in the Dashboard

Head to [dashboard.turen.io](https://dashboard.turen.io). Within a minute, you should see:

* Your agent appears under **Agents**
* LLM requests flowing in the **LLM Dashboard**
* Sessions available for replay under **Monitor > Replay**

## Next Steps

<CardGroup cols={2}>
  <Card icon="chart-pie" href="/dashboard/overview" title="Dashboard Overview">
    Learn what the dashboard shows you.
  </Card>

  <Card icon="shield-halved" href="/security-rules/overview" title="Security Rules">
    Explore the 96 built-in security rules.
  </Card>

  <Card icon="sliders" href="/policy/overview" title="Configure Policies">
    Customize policies for your organization.
  </Card>

  <Card icon="users" href="/administration/team-management" title="Team Setup">
    Invite your team and manage access.
  </Card>
</CardGroup>
