Skip to main content

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

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.
Settings profile

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.
Settings network

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).
Settings cloud

Display

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

Advanced

Release channel (stable, beta), HMAC signing knobs, setup-token escalation, and factory-reset. Power-user toggles live here.
Settings advanced

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

MethodPathUsed by
GET/api/configInitial load for all tabs
POST/api/v1/setup/applyBatch apply edits
POST/api/v1/setup/profileProfile + ground-role mutation
POST/api/v1/setup/cloud-choiceCloud sub-tab
POST/api/v1/setup/remote-access/cloudflareCloud sub-tab tunnel token

Troubleshooting

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