Installing to a USB flash drive
Updated 13 November 2026

When to use this method
cl-install-flash installs Calculate Linux on a USB drive: the drive becomes a formatted partition with a regular file system, not a sector-by-sector copy of the image. Use this method when you move a system between computers or install it on a computer without an internal drive, and also when you want to update the distribution on the drive without losing the files stored on it.
This method differs from writing an image (dd or a program such as Rufus) in that the utility creates a file system of the selected type on the drive, transfers the contents of the image into it as separate files, and installs the syslinux bootloader.
A system booted from such a drive runs in live mode: the compressed image is mounted read-only, and changes are stored only in RAM and disappear after a reboot.
What you need
The installation is performed from a running Calculate Linux — from a live drive or from an installed system. The utility is included in sys-apps/calculate-utils and is run as root.
Download the distribution image and place it in /var/calculate/linux: the utility looks for images in this directory and in /var/calculate/remote/linux, and the file location is set with the --iso parameter. The drive size must exceed the image size.
The system is installed to a disk partition with an MBR (dos) table. The --disk parameter expects exactly a partition, for example /dev/sdb1; the partition must not be used by the system and must not be located on the drive the system booted from.
Installation
Check which partitions are available for installation:
cl-install-flash -d list
* You need to select a distribution image. Use the --iso parameter. Installation disk: [/dev/nvme0n1p1] /dev/nvme0n1p1 (Samsung SSD 9100 PRO with Heatsink 4TB) [/dev/nvme1n1p1] /dev/nvme1n1p1 (KINGSTON SKC3000D4096G) [/dev/nvme2n1p1] /dev/nvme2n1p1 (Samsung SSD 990 PRO 4TB) [/dev/nvme3n1p1] /dev/nvme3n1p1 (KINGSTON SKC3000D4096G) [/dev/nvme3n1p2] /dev/nvme3n1p2 (KINGSTON SKC3000D4096G) [/dev/nvme3n1p3] /dev/nvme3n1p3 (KINGSTON SKC3000D4096G) [/dev/nvme3n1p4] /dev/nvme3n1p4 (KINGSTON SKC3000D4096G) [/dev/nvme4n1p1] /dev/nvme4n1p1 (Samsung SSD 970 PRO 1TB) [/dev/sde1] /dev/sde1 (WDC WUH 722422ALE6L4)
The list contains only partitions, while the drive model is shown in parentheses — that is how you identify the drive you need. The image is not specified here yet, so the first line is a reminder about the --iso parameter: it does not affect the list output.
Check which file system the partition can be formatted with:
cl-install-flash --fs list
File system on the USB device: [vfat] [btrfs] [ntfs] * [ext4] [ext3] [ext2] [xfs]
The output has been shortened: the lines with reminders about unfilled parameters are omitted. The default value is marked with an asterisk - ntfs: it is supported by both Windows and Linux, and the file size on it is not limited to 4 GB as it is with vfat.
Run the installation:
cl-install-flash --iso cldx-20261106-x86_64.iso -d /dev/sdb1
The utility will show the list of selected options ("Disk for installation", "File system on the USB device", "Format USB Flash"), after which you have to confirm the start of the installation. While running, it reports on formatting the partition ("Formatting partitions"), on copying the image contents ("Unpacking the system image"), on configuring the bootloader ("Configuring the Flash installation") and on finishing ("The system is installed!»).
When all options are known in advance, with -f there will be no repeated prompts (note that a partition with --format on is formatted from scratch, and everything that was on it is erased):
cl-install-flash --iso cldx-20261106-x86_64.iso -d /dev/sdb1 --format on -f
Here --format on is set explicitly because the partition is prepared from scratch; in other cases the utility formats the partition only if it is not formatted yet or the file system on it does not match the selected one.
When the installation is complete, reboot and select this drive in the boot menu of your computer.
Options
usage: cl-install-flash [--iso IMAGE] [-d DISK] [--fs FS_NAME]
[--format [ON/OFF]] [-f]
Installation to Flash:
--iso IMAGE ISO image to install
-d, --disk DISK install USB Flash ('list' to display the available
values)
--fs FS_NAME create a new file system on the USB device ('list' to
display the available values)
--format [ON/OFF] format the USB Flash
Common options:
-f, --force do not ask questions during the process
| Option | Purpose |
|---|---|
| --iso | image file; without the option the utility takes the image from the image directories |
| -d, --disk | drive partition; the list value displays the list of available partitions |
| --fs | partition file system: vfat, btrfs, ntfs, ext4, ext3, ext2, xfs; the list value displays the same list, the default is ntfs |
| --format | whether to prepare the partition: on or off |
| -f, --force | do not ask questions during the process |
Updating the image without formatting
If the drive already has a system installed and you only need to replace the image, disable formatting:
cl-install-flash --iso cldx-20261106-x86_64.iso -d /dev/sdb1 --format off
In this mode the utility removes the boot directories and the image files, and then writes the new ones; the other files remain in place. Before writing, the utility compares the size of the new image with the free space on the partition. Formatting is performed automatically if the file system on the partition does not match the one specified in --fs — with such an update the files will not be saved.
Writing the image from other systems
cl-install-flash works only in a running Calculate Linux, so from Windows, macOS, or another Linux you first write the drive with the tools of that OS, and then, booting from it, install the system to a second drive. A program that copies the image to the device as a whole will do, for example dd, Rufus, or balenaEtcher.
These programs do not save live session changes: the persistent partition needed for that is created by Rufus only for Ubuntu and Debian Live images, and each distribution has its own saving mechanism. To work from the drive permanently, use cl-install-flash.
Windows
Rufus - version 4.15, intended for Windows 8 and newer. Specify the drive and the image file, then start writing.
balenaEtcher - version 2.1.9; choose the image and the drive, and start writing. In Windows, eject the prepared drive with the built-in "Safely Remove Hardware" tool, otherwise the contents may remain in the write buffer.
macOS
balenaEtcher is also available for macOS (according to the official documentation, starting with 10.10 Yosemite), so it is usually the one used on a Mac. From the terminal, write the image with the dd utility; the write commands are run with sudo.
Find the drive in the list of disks:
diskutil list
Unmount the partitions of the drive, write the image, and eject it:
diskutil unmountDisk /dev/disk2
sudo dd if=cldx-20261106-x86_64.iso of=/dev/disk2 bs=1m
diskutil eject /dev/disk2
Write to the whole disk (/dev/disk2), not to one of its partitions: the image contains both the bootloader and the partition table.
Another Linux
Find the drive by size and by its removable flag — you need the lines of the disks themselves, not of their partitions:
lsblk -dp
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTS /dev/sda 8:0 0 5.5T 0 disk /dev/sdb 8:16 0 5.5T 0 disk /dev/sdc 8:32 0 5.5T 0 disk /dev/sdd 8:48 0 5.5T 0 disk /dev/sde 8:64 0 20T 0 disk /dev/zram0 251:0 0 121G 0 disk [SWAP] /dev/nvme1n1 259:0 0 3.7T 0 disk /dev/nvme2n1 259:1 0 3.6T 0 disk /dev/nvme3n1 259:2 0 3.7T 0 disk /dev/nvme0n1 259:3 0 3.6T 0 disk /dev/nvme4n1 259:11 0 953.9G 0 disk
The RM column distinguishes removable devices: it holds 1 in the line of the disk itself. The MOUNTPOINTS column shows mounted partitions; such a partition is unmounted before writing. Then run:
dd if=cldx-20261106-x86_64.iso of=/dev/sdb bs=4M status=progress
sync
A mistake in the device name after of= will lead to overwriting that disk and losing data, so check the device name against the lsblk output immediately before writing.
Several images on one drive
A drive prepared with cl-install-flash is formatted as ntfs by default — you can add other images to it as well. Place them in the /linux directory and update the boot menu:
mount /dev/sdb1 /mnt
cp cls-20261106-x86_64.iso /mnt/linux
umount /mnt
cl-setup-boot-live --type flash /dev/sdb1
Among third-party solutions, Ventoy does the same (version 1.1.18, builds for Windows and Linux): the program installs a bootloader on the drive and copies the distribution images to it as files, so new images are added without rewriting the drive.