# Install VARUA Remote Control on Linux

This is the official native Linux CLI setup for VARUA Remote Control. It connects an authorized Linux computer to ChatGPT, Claude, or another compatible MCP assistant. No Node.js runtime is required.

Setting up a different operating system or connecting from ChatGPT? Start with the official setup hub at https://varua.ca/setup.

## 1. Choose a project folder

Open a terminal on the Linux computer you want to connect. Keep your projects in a folder owned by your regular Linux user, for example:

```bash
mkdir -p "$HOME/projects"
```

The folders VARUA can access are selected by you. Do not run VARUA as root or with sudo.

## 2. Install VARUA

Run the official VARUA Linux installer as your regular user:

```bash
curl -fsSL https://downloads.varua.ca/varua-remote-control/install.sh | sh
```

The installer retrieves the native Linux client and checks the downloaded artifact. If you prefer the GUI or manual installation, visit https://app.varua.ca/dashboard/get-started.

## 3. Start the client

In a terminal, launch:

```bash
varua-rc
```

If the shell cannot find the command, check that `$HOME/.local/bin` is on your PATH. Keep the client terminal running while Remote Control is in use.

## 4. Pair your Linux computer

- Select only the project root that VARUA should access, such as `$HOME/projects`.
- Leave **file changes** and **command execution** disabled until you explicitly need them.
- Choose **Link device**, open the pairing page in your browser, and sign in using the same VARUA account as your AI assistant.
- Compare the verification code displayed by the client to the code shown by the website. Approve only if they match.
- Select **Start Remote Control**.

## 5. Verify the device is online

Open https://app.varua.ca/dashboard and verify that the computer shows **Online** under **Devices**. Return to your AI assistant and ask it to list your VARUA devices. Make a read-only test call before enabling additional permissions.

## Troubleshooting

- **`varua-rc` not found:** In your terminal run `export PATH="$HOME/.local/bin:$PATH"` and try again.
- **Pairing page did not open:** Copy the pairing URL shown by the client into your browser.
- **Pairing expired:** Generate a fresh pairing request from the client.
- **Device offline:** Restart `varua-rc` and keep the terminal open.
- **Want Windows or macOS instead?** Use https://varua.ca/setup.

The supported local command scopes are not an OS sandbox. Consult https://varua.ca/security before enabling process execution.
