Documentation for recent versions (Linutop OS V4) is available on


From LinutopWiki


Build a new OS V4 key from your Linutop

  • plug in a key (minimum 1G)
  • download and execute the installation script (you need to be connected to internet):
sudo bash
sudo lusm-web4 4

Build a new key from your Linutop (OS V3)

The following process can be used to install a Linutop OS on an USB key:

  • plug in a key (minimum 1G)
  • download and execute the installation script (you need to be connected to internet of course):
sudo bash lusm-web

After answering a few questions the latest stable system will be downloaded and installed.

If you need an other version of the system you can force it by using:

sudo bash lusm-web <version>

Note that the server on which the images are stored is managed by the Linutop team, and the installation program will check the validity of the downloaded and installed files according to data generated during the image build process. In other words, the script will tell you if the image you've installed is a non-corrupt and valid copy of the one we provide.


  • If the process fails (due to an Internet connection shutdown for instance), re-run the script, it will continue the download.

Build a new key from a Linux system

The lusm-web script can be used on any linux system. You need to have syslinux, mtools and parted installed (on Debian systems the packages will be installed for you if needed).

Simply download lusm-web and execute it as root:

bash lusm-web

Duplicate the key on the internal disk

Boot on the USB key you've just created and run in a terminal:

sudo lusm -d /dev/hda

You can also use the Linutop Backup tool in the "System" menu, you only need to choose /dev/hda as target and click on apply. This will flash the internal USB disk with the system of the USB key you are running.