HurricaneOS Documentation

This documentation explains how to run devices on HurricaneOS and how to ship your application to them: flashing a device, booting and provisioning it, connecting a Git repository, pushing code, and deploying a build to one device or your whole fleet.

It is written for two audiences.

Operators

People who prepare hardware and manage the device fleet — flashing disks, bulk provisioning, first boot, monitoring, and day-2 operations.

Developers

People who write the application and push code — connecting a Git repository, authoring docker-compose services, building, and deploying.

Where a step is operator-only or developer-only, it is marked.

Start here

How the system worksThe end-to-end flow from Git push to a running container, and the principles behind it.

Prerequisites & hardwareWhat you need before preparing a device.

Writing your applicationAuthor the docker-compose services that run on your fleet.

Reference & glossaryTroubleshooting and the terms used across this manual.