Debian-Ubuntu installation by packages¶

The Foreman packages should work on the following Debian-based Linux distributions:

• Debian Linux 5.0 (Lenny), see Installation_instructions
• Debian Linux 6.0 (Squeeze)
• Ubuntu Linux 10.04 LTS (Lucid Lynx)
• Ubuntu Linux 10.10 (Maverick Meerkat)
• Ubuntu Linux 11.04 (Natty Narwhal)

If you encounter any errors during the installation, please file a bug report!

Add one of the following lines to your /etc/apt/sources.list (alternatively in a separate file in /etc/apt/sources.list.d/foreman.list):

# Stable packages
deb http://deb.theforeman.org/ stable main

# Testing packages
deb http://deb.theforeman.org/ testing main

# Nightly builds. Beware: HERE BE DRAGONS
deb http://deb.theforeman.org/ nightly main

The public key for secure APT can be downloaded here

You can add this key with

apt-key add foreman.asc

or combine downloading and registering:

wget -q http://deb.theforeman.org/foreman.asc -O- | apt-key add -

The key fingerprint is

1DCB 15D1 2CA1 40EE F494  7E57 66CF 053F E775 FF07
Foreman Archive Signing Key <packages@theforeman.org>

To install Foreman, run

sudo apt-get update

# Depending on the database you want to use with Foreman,
# install one of these meta-packages:
sudo apt-get install foreman-mysql
sudo apt-get install foreman-pgsql
sudo apt-get install foreman-sqlite3

# or install the foreman main package and configure the
# database manually in /etc/foreman/database.yml
sudo apt-get install foreman

The only purpose of the meta-packages foreman-mysql, foreman-pgsql, and foreman-sqlite3 is to pull in any dependencies on the respective database system during the package installation. If you don't want to run the Foreman database on the same host, please use the foreman package and configure the database settings in /etc/foreman/database.yml. You cannot use dbconfig-common in this case.

Debian Linux 5.0 (Lenny)¶

Users of Debian Lenny will have to install rake and libsinatra-ruby from lenny-backports.

See http://backports.debian.org/Instructions/ for instructions on how to add lenny-backports to your list of repositories and install a package from it.