Skip to main content

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.

​
Start FERAL

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: 
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

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.