> For the complete documentation index, see [llms.txt](https://docs.arkelectron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.arkelectron.com/software/ark-os.md). # ARK-OS [ARK-OS](https://github.com/ARK-Electronics/ARK-OS) is ARK's companion computer software suite: a set of systemd services for MAVLink routing, video streaming, flight log management, firmware updates, and network RTK corrections, plus a web UI to manage it all. It ships pre-installed on the ARK Jetson image and on the Pi golden image. ## ARK-UI The web UI is served at `http://.local` (or the device's IP) — `jetson.local`, `just-a-pi.local`, `pi6x.local`. Pages: **System** (hardware and resource info, hostname), **Autopilot** (status, firmware update, reset), **Connections** (WiFi/Ethernet/LTE, data usage), **Services** (start/stop, autostart, logs, config editing), **Video** (live camera stream), and **Logs** (flight log download and upload to Flight Review).

Services page — start/stop services, toggle autostart, view logs, edit configs

## Services See the [Services](/software/ark-os/services.md) page for what each service does and which are enabled by default. ## Command-Line Tools ARK-OS puts its operator scripts on `PATH` (open a login shell and run them by name): ``` mavlink_shell.py # interactive PX4 NSH shell over MAVLink px4_shell_command.py # run a single PX4 console command flash_firmware.sh # flash flight controller firmware reset_fmu_fast.py # reset the flight controller reset_fmu_wait_bl.py # reset the flight controller into bootloader ``` Jetson carriers also ship: ``` jetson_serial_number.py # print the carrier serial number can_check.py can0 # check DroneCAN traffic on a CAN interface check_cameras.sh # stream-test the CSI cameras check_fan.sh # verify the cooling fan ``` ## Installing and Updating ARK-OS ARK-OS is distributed as a Debian package on the [releases page](https://github.com/ARK-Electronics/ARK-OS/releases). On Pi the packages are split by OS release — `ark-os-pi-trixie` for Raspberry Pi OS based on Debian 13, `ark-os-pi-bookworm` for Debian 12 — and the install script picks the right one. Run it from a clone of the repo on the device: ```bash git clone https://github.com/ARK-Electronics/ARK-OS.git cd ARK-OS sudo ./packaging/install_ark_os.sh --ark-os-version=X.Y.Z ``` {% hint style="warning" %} Upgrading resets the service configuration under `/etc/ark-os/` to packaged defaults — reconfigure via the web UI afterward. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.arkelectron.com/software/ark-os.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.