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.

Browser Dashboard

After the setup wizard finishes, the same URL at port 8080 becomes the ADOS Drone Agent’s live operations dashboard. The sidebar adapts to the profile the node was assigned (drone or ground station), the home page becomes a tile board of live telemetry, and every supporting screen (plugins, logs, diagnostics, settings) is one click away. This page is a tour. Each route also has its own page below it in the sidebar.

Open the dashboard

LinkURL
mDNShttp://ados.local:8080
Hotspothttp://192.168.4.1:8080
USB tetherhttp://10.55.0.1:8080
LANhttp://<node-ip>:8080
Any browser served the page from the agent’s own listener is trusted by the auth middleware (same-origin physical-presence model). Browsers on a remote LAN can pair an explicit API key in Settings → Cloud when the trust model is escalated.

Layout

Drone profile home
Top bar, left sidebar, main pane.
  1. Top bar — device name, profile badge, board, agent version, uptime, theme toggle, and a Mission Control quick-jump button on the right.
  2. Sidebar — profile-gated navigation. The shared rail (Home, Pairing, Plugins, Peripherals, Updates, Logs, Diagnostics, Settings) is always present. Drone nodes also see Telemetry and Video. Ground-station nodes see Receive, Display & Joystick, and the Mesh / Sources entries when their mesh role unlocks them.
  3. Main pane — the active route’s content.
For the per-route detail of what shows up on each profile, see the Per-profile visibility matrix.

First five minutes

1

Confirm health

Open Home. Every tile across the top should report a value (battery, link, video bitrate, CPU). Red or empty tiles point at missing hardware or services and link into the right detail screen.
2

Pair Mission Control

Open Pairing. Copy the six-character code, paste it into Mission Control’s “Pair a drone” dialog, and accept the pairing here. The Cloud tile on Home flips to “paired”.
3

Walk every screen

Click each sidebar entry once. The first visit warms the polling intervals so subsequent loads feel instantaneous.
4

Open Diagnostics

Confirm the systemd services list is green. A failing service is the fastest signal that hardware or config is off.

Backend endpoints

Every screen reads from one or more of these endpoints. The dashboard itself never requires an X-ADOS-Key header because same-origin browser requests are trusted by the agent.
MethodPathUsed by
GET/api/v1/setup/statusSidebar, top bar, profile gating
GET/api/v1/dashboard/snapshotEvery Home tile + ground panels
GET/api/status, /api/status/fullTop bar device card, uptime, board info
GET/api/systemDiagnostics CPU / memory / disk
GET/api/servicesDiagnostics services list
GET/api/v1/peripheralsPeripherals page
The full REST surface is documented in the REST API reference.