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

# Settings

> Five sub-tabs for profile, network, cloud, display, and advanced configuration.

# Settings

The Settings route has five sub-tabs, each editing one slice of the
agent's runtime config. Changes apply through `/api/v1/setup/apply`
which writes to disk and bounces the relevant services.

<Frame caption="Settings → Profile.">
  <img src="https://mintcdn.com/altnautica/5zXPDtKnZ8vtFffN/images/dashboard/drone/settings-profile-full.png?fit=max&auto=format&n=5zXPDtKnZ8vtFffN&q=85&s=37cf27ecbd974ab6839dd309e0fc13c3" alt="Settings profile" width="2880" height="1800" data-path="images/dashboard/drone/settings-profile-full.png" />
</Frame>

## Profile

The device's profile (drone or ground station), the ground role
(direct, relay, receiver), and the source the agent used to decide
(`detected`, `manual`, `wizard`). Editing the profile here calls the
same endpoint the wizard's profile step uses.

## Network

Hotspot, WiFi client, Ethernet, modem, and the uplink priority order.
The page mirrors the wizard's network step.

<Frame caption="Settings → Network.">
  <img src="https://mintcdn.com/altnautica/5zXPDtKnZ8vtFffN/images/dashboard/drone/settings-network-full.png?fit=max&auto=format&n=5zXPDtKnZ8vtFffN&q=85&s=7ba78a5f2824c1978d4f409ab42d2963" alt="Settings network" width="2880" height="1800" data-path="images/dashboard/drone/settings-network-full.png" />
</Frame>

## Cloud

Mission Control backend URL, MQTT broker, MQTT port, and the manually
configured API key (used when same-origin trust cannot be relied on,
e.g. across a tunnel).

<Frame caption="Settings → Cloud.">
  <img src="https://mintcdn.com/altnautica/5zXPDtKnZ8vtFffN/images/dashboard/drone/settings-cloud-full.png?fit=max&auto=format&n=5zXPDtKnZ8vtFffN&q=85&s=d11f8c3098e9ed3ddab54d0006f54bbd" alt="Settings cloud" width="2880" height="1800" data-path="images/dashboard/drone/settings-cloud-full.png" />
</Frame>

## Display

Local panel resolution, rotation, touch-calibration state, and
brightness. Ground stations also see the kiosk slot configuration
here.

<Frame caption="Settings → Display.">
  <img src="https://mintcdn.com/altnautica/5zXPDtKnZ8vtFffN/images/dashboard/drone/settings-display-full.png?fit=max&auto=format&n=5zXPDtKnZ8vtFffN&q=85&s=c65497fba62ded94ca8c971355cfdae8" alt="Settings display" width="2880" height="1800" data-path="images/dashboard/drone/settings-display-full.png" />
</Frame>

## Advanced

HMAC signing knobs, setup-token escalation, and factory-reset.
Power-user toggles live here.

<Frame caption="Settings → Advanced.">
  <img src="https://mintcdn.com/altnautica/5zXPDtKnZ8vtFffN/images/dashboard/drone/settings-advanced-full.png?fit=max&auto=format&n=5zXPDtKnZ8vtFffN&q=85&s=405ecc80c12e2a051d404b4f20b44279" alt="Settings advanced" width="2880" height="1800" data-path="images/dashboard/drone/settings-advanced-full.png" />
</Frame>

## Profile gating

Shared route, visible on both profiles. Some sub-tabs hide
fields that don't apply to the active profile (e.g., ground role on a
drone).

## Backend endpoints

| Method | Path                                     | Used by                        |
| ------ | ---------------------------------------- | ------------------------------ |
| GET    | `/api/config`                            | Initial load for all tabs      |
| POST   | `/api/v1/setup/apply`                    | Batch apply edits              |
| POST   | `/api/v1/setup/profile`                  | Profile + ground-role mutation |
| POST   | `/api/v1/setup/cloud-choice`             | Cloud sub-tab                  |
| POST   | `/api/v1/setup/remote-access/cloudflare` | Cloud sub-tab tunnel token     |

## Troubleshooting

<Accordion title="Edits don't seem to persist">
  Click **Save** in the affected sub-tab. The page does not auto-save;
  the apply round-trip is explicit so you can review the diff first.
</Accordion>

<Accordion title="Profile change refuses">
  Some changes require the wizard rather than the settings page (e.g.,
  flipping from drone to ground station triggers a hardware-check
  re-run). The page shows a banner pointing you at the wizard when this
  applies.
</Accordion>

## Related

* [Setup webapp](/drone-agent/setup-webapp)
* [Configuration](/drone-agent/configuration)