Debian-Ubuntu installation by packages » History » Version 11

« Previous - Version 11/12 (diff) - Next » - Current version
Greg Sutcliffe, 10/23/2012 10:34 AM

Debian-Ubuntu installation by packages

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


  • Debian Linux 6.0 (Squeeze)
  • Ubuntu Linux 12.04 LTS

Foreman might still work on these distros, but it has not been tested (let us know if it works for you):

  • Debian Linux 5.0 (Lenny)
  • Ubuntu Linux 11.04
  • Ubuntu Linux 10.10

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

Apt Configuration

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

# Debian Squeeze
deb squeeze stable
# Ubuntu Precise
deb precise stable

# Nightly builds. Beware: HERE BE DRAGONS

# Debian Squeeze
deb squeeze nightly
# Ubuntu Precise
deb precise nightly

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 -O- | apt-key add -

The key fingerprint is

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

Remember to update your package lists!

apt-get update

Install packages

The packages are now split by gem dependencies - there are 11 foreman* packages to choose from. These are:

Main package
  • foreman
Database gems - you need at least one of these
  • foreman-sqlite3
  • foreman-mysql2
  • foreman-mysql
  • foreman-pgsql
Optional functionality
  • foreman-console
  • foreman-fog
  • foreman-libvirt
  • foreman-ovirt
  • foreman-test
  • foreman-vmware

Installation instructions are:

# Install packages  (adjust additional packages as needed)
apt-get install foreman foreman-sqlite3 foreman-libvirt

# Copy sample db config to /etc
cp /usr/share/foreman/config/database.yml.example /etc/foreman/database.yml

# Review settings and DB config
vi /etc/foreman/settings.yaml /etc/foreman/database.yml

# Perform initial DB setup
su - foreman -s /bin/bash -c /usr/share/foreman/extras/dbmigrate

The packages should auto-run db:migrate if /etc/foreman/database.yml exists. So the initial db:migrate is only needed during first install, upgrades should just work.

Upgrading from 0.4.2

Upgrading from 0.4.2 to 1.0 has been tested on Debian 6 (32 and 64 bit) and we expect that simply upgrading should work fine:

apt-get update
apt-get dist-upgrade

The packages include a db:migrate, so your database will be migrated too. However, please note the new split-package architecture - you may want check and see if any of the new dependencies fit your usecase(s).

apt-cache search foreman