Hetzner - DokuWiki

Betriebssystem Images installieren/en


Installing Operating Systems using 'installimage'

The installimage script provided by Hetzner offers an easy and fast installation of various Linux distributions.

Installimage can be run directly from the rescue system on your server. It offers a menu driven interface where you can select a Linux distribution of your choice. You have full control over the partitioning of your hard disc(s) and can activate the use of sofware RAID as well as LVM in a simple editor.


If installimage finds a file /autosetup in the rescue system, it is automatically used as configuration file. No menu and no editor are displayed unless there are errors in the file.

Which operating systems can be installed?

The menu lists the currently offered operating systems. Advanced users can also create their own OS images and install them. Please see the guide how to install your own OS images and the requirements for creating them.

How do I use 'installimage'?

First you need to activate the rescue system in the administration web interface Robot (menu "Server" -> choose the desired server -> tab "Rescue"). We are offering a 32bit as well as a 64bit rescue system. Please make a note of the password that is displayed after activation.

Now you need to reset the server either through Robot or by doing a normal reboot.

After a couple of minutes the rescue system should be fully booted. You should now be able to login as 'root' via SSH using the password that was displayed in Robot.

Finally the installation procedure can be started:

root@rescue ~ # installimage

You will see a menu, where you can choose a Linux distribution and a list of images in each submenu.

Example of the images menu (Note: the current offer of images could be different)

After choosing an image, you will receive a note that now the editor will be started which opens the config file.

As editor Midnight Commander (‚mcedit’) is being used.

Normally you will only need to check if the correct hard disc is used and if the partitioning is okay.

NOTE: The config file automatically lists the first and second hard disc that is detected. Please verify if the variable "DRIVE1" matches the desired disc where the operating system should be installed (SATA: /dev/sda, IDE: /dev/hda etc).

After leaving the editor with F10 (save and quit), the syntax of the config file is checked. Should it contain errors, you will be returned to the editor. If everything is okay, the first line should show:


now you will be asked for confirmation for each hard disc


If you are seeing this output after 1-15 minutes (depends on image and partitioning), the system is ready and bootable.

The root password is set to the current password of the rescue system.

After ‚reboot’ in the rescue system:

root@rescue ~ # reboot

the new installed system is booted and you can login with the previous rescue password.


  • When installing Debian or Ubuntu using the installimage script, the times for the cronjob in /etc/cron.d/mdadm are set randomly.

Frequently Asked Questions

Am I losing data on the hard disc(s)?
Yes. The chosen disc(s) are completely erased and a new partition table is created.
The installation script shows one or multiple errors. What should I do now?
First please re-run the installation. Should you get the same error again, weil send the complete screen output and the contents of the file /root/debug.txt to support@hetzner.de.
Do I have to put all at the end of the partition table or can I put this line further at the top?
The size all in the config file means use all currently available space of the hard disc. Since partitions are created one after another, the partition table will end after using 'all' because there is no space available afterwards. Of course, it is also possible not to use all' at all.
I have two (or more) discs installed. Can the installimage script automatically create a software RAID?
Yes, the script can create software RAIDs with levels 0, 1, 5, 6 and 10.

The config file has two options SWRAID and SWRAIDLEVEL for this feature. If the option SWRAID is activated (1) a software RAID with the level SWRAIDLEVEL is created.

Pressing F10 does not work. Instead "~21" (or something similar) is displayed.
Press Escape and then "0". In most cases this has the same effect as F10.
Can I use logical volumes (aka LVM)?
Yes, see comments in the section about partitioning.
I get the error message „Due to maintenance the installimage-script is temporarily unavailable. We are sorry for the inconvenience.“
Should you get this message, parts of the script are being updated. This usually only takes a couple of minutes. The lock during the update is necessary to prevent the scripts from being run and causing errors. You should be able to run the script again after a couple of minutes after receiving this message.
Who is the author of the script? Can I use it freely?
The scripts are written by Florian Wicke in Bash for Hetzner Online AG. They were extended by David Mayr and others. The script is publicly available and the programming language is available under GPL. Hetzner Online AG and the authors cannot be held responsible for any damages which are caused by altered versions. No support is provided for any guides that include changes to the script.

© 2020. Hetzner Online GmbH. Alle Rechte vorbehalten.