For Katello 1.4 users looking for information on how to transition to 2.0, please see - Transition Guide.
Note: After installation of Katello, be sure to trust Katello’s CA certificate on your system. This is required for the encrypted NoVNC connections. You will find
katello-default-ca.crt in the
/pub directory of your Katello server (e.g.
Katello may be installed onto a baremetal host or on a virtual guest. The minimum requirements are:
The following ports need to be open to external connections:
Katello provides a puppet based installer for deploying production installations. Production installations are supported on the following OSes:
|-----------+-----| | OS | | |-----------|-----| | CentOS 6 | X | | CentOS 7 | X | | RHEL 6 | X | | RHEL 7 | X | |-----------+-----|
Katello can only run on an x86_64 operating systems.
Installation may be done manually or via our recommended approach of using forklift.
Select your Operating System:
yum -y --disablerepo="*" --enablerepo=rhel-6-server-rpms install yum-utils wget yum-config-manager --disable "*" yum-config-manager --enable rhel-6-server-rpms epel yum-config-manager --enable rhel-6-server-optional-rpms
yum -y localinstall http://fedorapeople.org/groups/katello/releases/yum/2.4/katello/RHEL/6Server/x86_64/katello-repos-latest.rpm yum -y localinstall http://yum.theforeman.org/releases/1.10/el6/x86_64/foreman-release.rpm yum -y localinstall http://yum.puppetlabs.com/puppetlabs-release-el-6.noarch.rpm yum -y localinstall http://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm yum -y install foreman-release-scl
yum -y --disablerepo="*" --enablerepo=rhel-7-server-rpms install yum-utils wget yum-config-manager --disable "*" yum-config-manager --enable rhel-7-server-rpms yum-config-manager --enable rhel-7-server-optional-rpms yum-config-manager --enable rhel-7-server-extras-rpms
yum -y localinstall http://fedorapeople.org/groups/katello/releases/yum/2.4/katello/RHEL/7Server/x86_64/katello-repos-latest.rpm yum -y localinstall http://yum.theforeman.org/releases/1.10/el7/x86_64/foreman-release.rpm yum -y localinstall http://yum.puppetlabs.com/puppetlabs-release-el-7.noarch.rpm yum -y localinstall http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm yum -y install foreman-release-scl
After setting up the appropriate repositories, install Katello:
yum -y install katello
At this point the
katello-installer should be available to setup the server. The installation may be customized, to see a list of options:
Prior to running the installer, the machine should be set up with a time service such as ntpd or chrony, since several Katello features will not function well if there is minor clock skew.
These may be set as command line options or in the answer file (/etc/katello-installer/answers.katello-installer.yaml). Now run the options:
Foreman provides a git repository designed to streamline setup by setting up all the proper repositories. Forklift provides the ability to deploy a virtual machine instance via Vagrant or direct deployment on an already provisioned machine. For details on how to install using forklift, please see the README.
Release candidates for Foreman 1.16.0-RC1 are now available, please help testing the new release. Read about all of the changes in the release notes, and follow the quick start to install it.
A new bug fix release for Foreman 1.15 is available. See the Foreman 1.15.6 release notes for more details.