Installing and booting a TurtiniOS appliance

TurtiniOS ships as a bootable disk image. You install it once; from then on it updates itself.

The shape of it:
The OS is a single immutable image with two slots (A/B). Updates are written to the spare slot and the machine switches to it on the next boot, so an update is atomic — it either fully applies or it doesn't, and a bad one rolls back automatically.

Bringing a machine up:
1. Write the TurtiniOS disk image to the target — a bare-metal server, a workstation, an edge device, or a VM.
2. Boot it. On first boot it detects its hardware, picks a role (server / workstation / edge), measures its integrity, and starts the services for that role.
3. Provide any provisioning values it needs — for a server that joins your fabric, that's the fabric address and an enrollment token; for the VM console, a shared secret. These are injected at provisioning time (not baked into the image) so no secrets ship inside it.

After boot:
A server node brings up the Turtini stack and, if it has virtualization, advertises itself as a Cloud host. A workstation opens the Turtini kiosk. An edge node joins the fabric. You'll see each machine appear in the Cloud module's Nodes tab.

For the specific provisioning steps (fabric join, console secret), see "Connecting a node to the fabric" and "Provisioning the VM console secret."