Installing latest code¶

Latest stable version can be found under the files section

Latest source code¶

Latest development code¶

Foreman has now moved to using Rails 3 and Bundler to get up and running. This is the preferred way to get Foreman if you want to benefit from the latest improvements. By using the git repository you can also upgrade more easily. You will need to have Bundler installed manually for now (check your distribution repositories, or install it via rubygems).

to get latest "development" version do:

You will want to make sure that you have one of the mysql-devel, postgresql-devel, and sqlite-devel libraries installed so the database gems can install properly.
also, you would also need gcc ruby-devel, libxml-devel, libxslt-devel and libvirt-devel packages

git clone https://github.com/theforeman/foreman.git -b develop
cd foreman
# must have the bundler gem installed -- gem install bundle
bundle install --without mysql mysql2  sqlite test development --path vendor # or postgresql
cp config/settings.yaml.example config/settings.yaml
cp config/database.yml.example config/database.yml
RAILS_ENV=production bundle exec rake db:migrate # (to set up database schema)

You can run Foreman with the command "RAILS_ENV=production rails s"

Latest stable version¶

The old rails2 version still available under a branch

to get latest "stable" version do:

git clone https://github.com/theforeman/foreman.git -b 0.4-stable
cd foreman
git submodule init
git submodule update

if you are behind a proxy or firewall and dont have access to github using the git protocol, use http protocol instead (e.g.)

git clone https://github.com/theforeman/foreman.git foreman
cd foreman
sed -i 's/git:\/\//http:\/\//g' .gitmodules
git submodule init
git submodule update

Daily snapshot¶

You can also fetch the latest daily snapshot of the 0.4 stable version at:
http://theforeman.org/foreman-nightly.tar.bz2