Installation Guide

Welcome to the Haiku installation guide! This document will help you install Haiku on your computer, guiding you through the Haiku installation one step at a time. Depending on your hardware configuration, the installation process can take as little as 15 minutes.

Preparing a Partition for Haiku

Currently, Haiku cannot resize existing partitions; therefore, you either need to already have an empty partition where you can install Haiku, or you need to create one using a third party tool. If your current OS comes with a partitioning tool, try to use that. Otherwise, you can use specialized tools like the freely available GParted LiveCD. A standard install of Haiku requires about 700MB of disk space, so the partition doesn't need to be huge. However, you may want to leave some room for stuff, so 2GB may be an appropriate partition size.

Whenever your disk has multiple partitions, you will also need a boot loader such as GRUB to be able to boot into Haiku (and any other systems that you may have installed in the remaining partitions). In some cases, it is also possible to use the Haiku Boot Manager.

Let's Start the Installation!

Insert the Haiku Installer CD into your CD-ROM drive and power up your system. After a few seconds, you should see the following Haiku boot splash screen.

If any of the screens below fail to appear, try the fail safe mode options which can be enabled by holding SHIFT before the CD starts to load. See Boot Loader for details. Please also consider reporting the issue at the bug tracker.

Haiku boot splash screen

The following panel (depending on your hardware it can take a while to appear) lets you set the system language and keymap.
Then you have to decide to either install Haiku on a partition by clicking Run Installer or try out Haiku by booting to the desktop directly from CD by choosing Desktop (Live-CD).

Choose the Installer option

Before the Haiku Installer starts, the following notice is displayed. It contains some information regarding prior partition setup as above and GRUB setup as further below in this guide. Click on the Continue button to proceed to the Installer.

Some pre-install information

If the following alert pops up, this means that no partitions with the Be File System (BFS) have been found. Click on Ok. Note that if there are already BFS partitions on your system, this alert will not be shown.

No BFS partitions were found

When you don't have a BFS partition available where Haiku can be installed to, or if you want to use a different partition, you will need to use the DriveSetup partitioning application. To start DriveSetup, click on the Setup partitions… button.

Start DriveSetup

The Haiku partition manager DriveSetup appears and shows the disks and partitions that have been identified. An example setup is shown below.

The initial DriveSetup view

In this example you can see that there already are two primary partitions. One of about 9GB using an Ext File System, and another one of 2GB with a FAT32 File System. There are also two extended partitions that are still empty. These partitions have been previously prepared using a partitioning tool. Now choose the partition you want to install Haiku on by selecting it from the list. As soon as you select a disk, the partition layout will also be graphically represented. You can then also choose the partition by clicking on it in the layout graphic. The currently selected partition is marked by a blue border in the layout graphic and by a darker gray color in the list.

Select the target partition

To initialize a partition to the Be File System, make sure the right partition is selected, then use the menu Partition -> Initialize and click on Be File System....

Select the Be File System for initialization

A prompt will come up that asks you if the initialization should be started. If you are still sure you have the right partition selected, click on the Continue button; otherwise, quit the initialization by clicking on Cancel. As the alert says, you can still abort initialization before writing any changes to disk.

Continue from the alert

The next step is used to enter a name for the new partition that you are about to initialize. Enter the name you would like your new partition to have, or simply leave the suggested "Haiku". Here you can also select a blocksize if you want; the default blocksize of 2048 should be fine for most uses, so you can leave this as is. Afterwards, click on Initialize to continue.

Fill in the file system name

This is the last step before the initialization is executed! All data on the selected partition will be irrecoverably lost!

If everything still looks fine, click on Write Changes; otherwise, quit using the Cancel button.

Warning before writing back changes

The partition has been initialized with the Be File System. Click on Ok to close this notification.

The partition has been initialized to the Be File System

You can now see the file system type and name has been updated in the list. Also, the graphical representation should now bear the correct name. The partition setup is now complete. Exit DriveSetup by clicking on the left upper corner of the tab or use ALT W.

Quit DriveSetup

The Installer will become visible again and should now show an updated list of target partitions under Onto like in the following screen. You can now choose your freshly initialized partition (or a pre-existing one if you already had one) as the installation target.

Select target volume

The volume with the name Haiku has been chosen as the target for installation and we are now ready to begin. Click on Begin to start the installation.

Begin the installation

The installation process collects some information before starting to copy data. This can take a few seconds to process.

The copy process starts

Soon after that, files start to be copied and a progress bar with a file count is displayed as seen in the screenshot below.

The Installer copies files

While the copying is taking place, it is always possible to quit the process by clicking on the Stop button.

Installation is complete

When the copying process is finished, you can quit the installer by clicking on Quit. The install CD will be ejected, and the system will restart after a few seconds. Do not forget to remove the Haiku CD from your drive.

Note that the Installer will take no steps to integrate Haiku into an existing boot manager menu. The Haiku partition itself will be made bootable, though. From the Tools menu you can launch the Boot Manager that puts a menu in the boot sector to choose what operating system to boot.
Boot Manager isn't yet tested very well and still has a few restrictions that it will complain about if they aren't met: the menu can only be installed on your first harddisk and there has to be a 2KiB space after the Master Boot Record (MBR).
You don't need to run Boot Manager if you already use a bootmanager like Grub, in which case you have to add Haiku manually, or Haiku runs exclusively on your machine. The Boot Manager panel will guide you through installing or uninstalling the boot menu.

Please see below for how you can add Haiku to an existing GRUB installation or how to use the CD to boot into a Haiku installation without adding it to the boot manager.

Adding Haiku to GRUB

If you have GRUB already installed, you can add Haiku to its boot menu. Depending on what version of GRUB you use, this is done differently.

GRUB 1

Configure your /boot/grub/menu.lst by launching your favorite editor from a Terminal like this:

	sudo <your favorite text editor> /boot/grub/menu.lst

You'll note that GRUB uses a different naming strategy for hard drives than Linux. With GRUB it's: (hdN,n)

  • All hard disks start with "hd".
  • N is the hard disk number, starting with "0".
  • n is the partition number, also starting with "0".
    The first logical partition always has the number "4", regardless of the number of primary partitions.
So behind the other menu entries towards the bottom of the file, add something similar to these lines:

	# Haiku on /dev/sda7
	title		Haiku
	rootnoverify	(hd0,6)
	chainloader	+1

You can see the correct partition in GParted for example.

GRUB 2

Newer versions of GRUB use an extra configuration file to add custom entries to the boot menu. To add them to the top, you have to create/edit a file by launching your favorite editor from a Terminal like this:

	sudo <your favorite text editor> /etc/grub.d/40_custom

NOTE: While the naming strategy for hard disks is still as described under GRUB 1, the naming scheme for partitions has changed. GRUB's naming scheme is still: (hdN,n)

  • All hard disks start with "hd".
  • N is the hard disk number, starting with "0".
  • n is the partition number, which for GRUB 2 starts with "1"
    With GRUB 2 the first logical partition always has the number "5", regardless of the number of primary partitions.
So below the heading that must not be edited, add something similar to these lines:

	# Haiku on /dev/sda7
	menuentry "Haiku Alpha" {
		set root=(hd0,7)
		chainloader +1
	}

You can see the correct partition in GParted for example.

Additionally you have to edit another file to actually display the boot menu:

	sudo <your favorite text editor> /etc/default/grub

Here you have to comment out the line "GRUB_HIDDEN_TIMEOUT=0" by putting a "#" in front of it in order to actually display the boot menu.

Finally, you have to update the boot menu by entering:

	sudo update-grub

Not using GRUB

If you use an other boot manager than GRUB, please consult its documentation on how to add a new operating system.

Boot using the CD

You can also use the boot CD to boot into your Haiku installation without adding it to a boot manager. To do so, press SHIFT before the CD begins to load. This will bring up the boot loader menu as seen in the following screenshot.

The Boot Loader Menu

To choose the installation to boot from, press Enter to navigate to the boot volume selection. Your installation should now be listed.

Select the boot volume from the list

Select the volume using the arrow keys and press Enter again to choose it as the boot volume. You will be returned to the main boot loader menu which now shows your choice as shown below.

Continue booting to boot Haiku

The selection will automatically jump to Continue booting. Press Enter again to start booting into your Haiku installation.

First Boot

Once fully booted, you should be greeted by a screen like the one shown below.

The fully booted Haiku system

Some background processing will still take place the first time you boot Haiku, so don't be alarmed by the disk activity. After a little while, the system should settle down. Make sure to read our Welcome documentation; there is a link on the Desktop.

Have fun and thanks a lot for trying out Haiku! We hope you'll like it! If you run into what you believe to be a bug, please file a report in our bug tracker. Before filing a bug report, please take the time to quickly check if your issue has already been reported; it if has, then please add a comment if you have additional information, like how to reproduce the problem. If the issue hasn't been reported before, create a new ticket and provide as many useful details as you can.