Make your own Companion stick
This page is for a stick you supply and write yourself. Companion writes each stick it sells before it ships, so buyers do not need this page. The write step runs on Linux, and no physical write is recorded yet.
Status. Host install and the signed updater are planned, not provided. Writing to a physical stick is not yet proven. To buy a stick instead, see the Companion stick page.
Before you start
Check these conditions before you download anything.
- The write step runs on Linux.
- The target computer must be an x86_64 PC with UEFI firmware. Apple silicon cannot boot the stick. arm64 and CachyOS cannot boot it either.
- If the target is an Intel Mac with a T2 chip, set Startup Security to No Security and allow external boot first. The status for that machine is Not yet proven.
- Use a USB stick of 57 GiB or more.
- Writing to the stick replaces everything on it. Use a stick that holds nothing you need.
Steps
The steps run in order. Steps 1 and 2 get and check the bundle, and step 3 prints the write plan. Do not write the stick until you have done all three.
Get the signed bundle
Status: Planned. No release has been signed with the pinned key yet. Get the signed bundle once a release exists.
Verify the bundle
Status: Built. Verify the bundle before you write anything. The checksum step is part of this check. The tool checks the detached ed25519 signature before it hashes anything. Then it checks expiry and the rollback floor, and then the size and the SHA-256 checksum. If a check fails, stop. Do not write the stick.
Print the write plan
Status: Built. Run ci-stick flash --dry-run. It prints the write plan. Read the plan before you continue.
Write to the stick
Status: Not yet proven. On Linux, run ci-stick flash --device --confirm NODE. Replace NODE with the device node of your stick, such as /dev/sdX. The tool reads the stick back after it writes. Writing a 128 GB stick is estimated at about an hour. That time has not been measured. No release has been signed with the pinned key yet, so a physical stick cannot yet be written from a release bundle.
Start the PC from the stick
Status: Not yet proven for Companion OS. Start the PC from the stick. Stock Ubuntu 26.04.1 Desktop boots from a slot with Secure Boot on. Companion OS slot boot is not yet proven.
Switch to slot B
Status: Built. If you want to boot from slot B, run ci-stick slot set B.
Start for the first time and pair
Status: Not yet proven. Start Companion OS for the first time. Then pair the device with your CI Account at hub.ci.computer. See Device pairing.
Status of each part
| Part | Status |
|---|---|
| Verify signed bundles | Built |
Print the write plan (flash --dry-run) | Built |
Switch slots (ci-stick slot set B) | Built |
Write to a physical stick (flash --device) | Not yet proven |
| Companion OS slot boot | Not yet proven |
| Companion OS Secure Boot | Not yet proven |
Host install (ci-stick install) | Planned |
| Signed updater | Planned |
| Apple silicon, arm64, and CachyOS | Not supported |
The Companion stick status page lists the evidence behind each row.
Next
- Install steps and partitions: the seven install steps as a sequence diagram, and the partition plan for the 128 GB stick.
- Companion stick status: the evidence behind each status label.