Follow @Openwall on Twitter for new release announcements and other news
Owl homepage
Other languages
Build environment
Installation instructions
Upgrade instructions
Download (HTTP, FTP, rsync, anoncvs)
Change logs
Changes in current
Changes in 3.1-stable
Changes up to 3.1
Changes in 3.0-stable
Changes up to 3.0
Changes in 2.0-stable
Changes up to 2.0
Changes in 1.1-stable
Changes up to 1.1
Changes up to 1.0
Changes in 0.1-stable
Presentation slides
OpenVZ virtualization
Owl VPS hosting
Owl in the news
The instructions below apply to Owl 3.0. For older versions of Owl, please refer to Owl/doc/INSTALL as included in the "native" tree for your version (that's /usr/src/world/native/Owl*/doc/INSTALL on the CDs).

Currently, there are two primary ways to install Owl - by booting off an Owl CD or by using another Linux installation you may already have.

Installing from a local CD-ROM drive.

If you don't already have an Owl CD, please either order one or see DOWNLOAD for locations where you may obtain the ISO-9660 CD images and burn one onto a CD-R.

Boot off the CD. When the boot menu appears, hit Enter (choosing the default boot target called "normal") or simply wait a few seconds.

Owl should boot into single user mode. Once in the shell, you can optionally configure the CD-booted system by simply typing:


The configuration will be stored in RAM (parts of /etc and /var are on a ramdisk). You may then exit the shell to let the system boot into multi-user mode. Of course, this step is optional and is only needed if it is more convenient to complete the installation while in multi-user mode (e.g., operating from a remote workstation) or if you intend to actually use the CD-booted Owl without installing on a hard disk.

To actually install Owl, type:


This will invoke the installer that will guide you through the installation process.

Using an existing Linux installation.

Note: these requirements and instructions are only relevant to you if you chose to not install from an Owl CD for whatever reason. Most people use a CD and don't need this.

A suitable Linux installation needs to offer some GNU tools and rpm2cpio. It does not have to use RPM as its package manager.

You need to prepare the usual /usr/src/world setup as explained in BUILD. Then proceed to install the new system:

Use fdisk(8) to partition your disks for Owl as desired. Use mkfs(8) and mkswap(8) to create filesystems and initialize swap space. Use mount(8) to mount the new root filesystem at /owl. Similarly, mount any additional filesystems at their appropriate locations under /owl. To actually install Owl, change directory to /usr/src/world and type:

	KERNEL_FAKE=no make installworld && make setup

If there are any problems during the "installworld" stage (watch for the "Failed" lines), correct their cause and re-run the command.

The setup program (invoked by "make setup" above) helps you take care of some of the configuration settings for the newly installed system, but it does not currently create /etc/fstab. You need to do this manually.

Once the Owl tree is installed, you need to configure a boot loader. Note that the boot loader setup needs to be done chrooted to your newly installed userland:

	chroot /owl

Currently, Owl supports Linux 2.6.x kernels. We recommend that you use the version provided with your copy of Owl.

You may choose to configure the boot loader available with Owl (LILO or SILO, depending on the architecture), or you may use a boot loader already installed on the system (if any).

Once the installation is complete, make sure to manually unmount the filesystems with umount(8) prior to rebooting the system.

$Owl: Owl/doc/INSTALL,v 1.28 2010/12/14 16:37:05 solar Exp $