h1. 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-50-Lenny]]

* 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@):

<pre>

# 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

</pre>

The public key for "secure APT":http://wiki.debian.org/SecureApt can be downloaded "here":http://deb.theforeman.org/foreman.asc

You can add this key with

<pre>

apt-key add foreman.asc

</pre>

or combine downloading and registering:

<pre>

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

</pre>

The key fingerprint is

<pre>

1DCB 15D1 2CA1 40EE F494  7E57 66CF 053F E775 FF07

Foreman Archive Signing Key <packages@theforeman.org>

</pre>

To install Foreman, run

<pre>

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

</pre>

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.

h3. Debian Linux 5.0 (Lenny)

Users of Debian Lenny will have to install "rake":http://packages.debian.org/lenny-backports/rake and "libsinatra-ruby":http://packages.debian.org/lenny-backports/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.