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

# macOS

> Install Turen on macOS

## Requirements

* macOS 13 (Ventura) or later
* Apple Silicon (M1+) or Intel
* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
* Admin access (for installation)

## Install

Download the Turen agent installer (`.dmg`) from the **Downloads** section of your [Turen dashboard](https://dashboard.turen.io). You'll need a registration key: generate one from **Agent Settings > Registration Keys** before starting.

Open the DMG and follow the installation prompts. You'll be asked to enter your registration key during installation.

The installer will:

* Install `turen-watchdog`, `turen-proxy`, and `turen-pkg`
* Register the machine with your Turen organization
* Configure Claude Code automatically via `managed-settings.json` (environment variables and hooks)
* Start the agent as a background service (LaunchDaemon)

Once complete, 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 launchctl unload /Library/LaunchDaemons/dev.turen.watchdog.plist

# Start the agent
sudo launchctl load /Library/LaunchDaemons/dev.turen.watchdog.plist

# View agent logs
log show --predicate 'subsystem == "dev.turen.watchdog"' --last 5m
```

## Uninstall

```bash theme={null}
# Stop the service
sudo launchctl unload /Library/LaunchDaemons/dev.turen.watchdog.plist

# Remove files
sudo rm -rf /usr/local/bin/turen-watchdog
sudo rm -rf /usr/local/bin/turen-proxy
sudo rm -rf /Library/LaunchDaemons/dev.turen.watchdog.plist
rm -rf ~/Library/Application\ Support/Turen
```

## Other Platforms

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