Get started with VelaOS

Flash an installer ISO, boot your thin client, enter a VelaOS Code. ~12 minutes from USB plug to enrolled device.

What you need

UEFI x86-64 device

Wyse, HP, Lenovo, NUC

≥ 4 GB RAM, ≥ 32 GB disk

TPM 2.0 recommended

Network

Wired or Wi-Fi

USB stick

8 GB for the installer

Setup guide

1

Flash the installer ISO to a USB stick

Download the VelaOS installer ISO (it's based on AlmaLinux 10.1 with the VelaOS bootc switch + kickstart pre-baked), then write it to an 8 GB+ USB drive with Rufus (Windows) or dd (macOS/Linux).

Verify the ISO's SHA-256 checksum + cosign signature before flashing. Both are linked from the release page; cosign verify-blob against the VelaOS public key seals the supply chain.
2

Boot the device from USB

Plug the USB into your thin client, power on, and press the boot-menu key (F12 on Dell/HP, F11 on Lenovo). Pick the USB device. The kickstart takes over — no prompts, no choices. It partitions with LUKS2 + TPM sealing, installs the minimal base, runs bootc switch to the signed VelaOS image, and reboots.

# Typical timing on a Wyse 5070 / HP t640:

Partition + LUKS 1 min 30 s

Install minimal base 2 min

bootc switch + sign 3 min

Reboot into VelaOS 30 s

3

Enrol with a VelaOS Code

On first boot you see a 7-character VelaOS Code + a QR of the same code. The agent waits for approval — no credentials leave the device until you click Approve in the console. For fleet deployments, the tenant org code is baked into the ISO so enrolment happens automatically with no operator input.

Devices → Pending → “Enter VelaOS Code”. Approve, assign a group, you're done.

Approve + manage

The device shows in your console with a yellow “pending” badge. Click Approve, assign a group, and policy + Vela Catalog subscriptions push over MQTT within seconds. Every bootc update goes through A/B slots with Greenboot gating — a failed health check rolls back automatically.

Push app subscriptions
Enforce tri-state policy
Live-view screenshot
Collect diagnostics
Create free account

Free for up to 5 devices. No credit card. No sales call.