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

# First Run

> What actually happens on first launch, including access mode and pairing behavior.

## Start FERAL

```bash theme={null}
feral start
```

This boots the brain + dashboard on `http://localhost:9090` and runs setup when config is missing.

## Setup flow

### 1) Provider

Pick your LLM provider and model (cloud or local).

### 2) Credentials

For cloud providers, enter API keys. Local model providers can run without API keys.

### 3) Identity (optional)

Set user profile fields used by personalization and prompting.

### 4) Autonomy profile

Choose how strict vs automatic actions should be.

### 5) Pair your phone (critical)

Choose one access mode:

* **Same WiFi**: local LAN pairing.
* **Anywhere**: remote pairing through Tailscale Funnel.
* **This Mac only**: skip phone pairing for now.

If you choose **Anywhere**, setup attempts `remote-up` automatically.
If it fails, run this once in a terminal:

```bash theme={null}
feral access remote-up
```

### 6) Finish

Setup writes config and returns you to the main dashboard.

## Pairing after setup

1. Open `Devices`.
2. Click `Pair new device`.
3. Use `Web phone` tab.
4. Generate and scan QR.
5. Complete PIN and permission steps on phone if prompted.

## Verify status

```bash theme={null}
feral status
feral access status
```

## Common first-run mistakes

* Pairing while mode is **This Mac only** (`localhost`) -> no pair URL is emitted.
* Choosing **Anywhere** and ignoring setup tunnel errors without running `feral access remote-up`.
* LAN URL unreachable because brain is loopback-only -> restart with `FERAL_HOST=0.0.0.0`.