Katello integrates open source systems management tools into a single solution for controlling the lifecycle of your machines.
Ruby JavaScript HTML CSS
Switch branches/tags
rubygem-katello-2.4.0-2 rubygem-katello-2.4.0-1 rubygem-katello-2.3.1-3 rubygem-katello-2.3.1-2 rubygem-katello-2.3.1-1 rubygem-katello-2.3.0-7 rubygem-katello-2.3.0-6 rubygem-katello-2.3.0-5 rubygem-katello-2.3.0-4 rubygem-katello-2.3.0-3 rubygem-katello-2.3.0-2 rubygem-katello-2.3.0-1 rubygem-katello-2.2.4-1 rubygem-katello-2.2.3-2 rubygem-katello-2.2.3-1 rubygem-katello-2.2.2-2 rubygem-katello-2.2.2-1 rubygem-katello-2.2.1-1 rubygem-katello-2.2.1-0 rubygem-katello-2.2.0-11 rubygem-katello-2.2.0-10 rubygem-katello-2.2.0-9 rubygem-katello-2.2.0-8 rubygem-katello-2.2.0-7 rubygem-katello-2.2.0-6 rubygem-katello-2.2.0-5 rubygem-katello-2.2.0-4 rubygem-katello-2.2.0-3 rubygem-katello-2.2.0-2 rubygem-katello-2.2.0-1 rubygem-katello-2.1.2-3 rubygem-katello-2.1.2-2 rubygem-katello-2.1.1-2 rubygem-katello-2.1.1-1 rubygem-katello-2.1.0-5 rubygem-katello-2.1.0-4 rubygem-katello-2.1.0-3 rubygem-katello-2.1.0-2 rubygem-katello-2.1.0-1 rubygem-katello-2.0.0-6 rubygem-katello-2.0.0-5 rubygem-katello-2.0.0-4 rubygem-katello-2.0.0-3 rubygem-katello-2.0.0-2 rubygem-katello-2.0.0-1 rubygem-katello-1.5.0-12 rubygem-katello-1.5.0-11 rubygem-katello-1.5.0-10 rubygem-katello-1.5.0-9 katello-utils-1.4.1-1 katello-utils-1.3.2-1 katello-utils-1.3.1-1 katello-utils-1.2.1-1 katello-utils-1.1.2-1 katello-utils-1.1.1-1 katello-selinux-1.4.1-1 katello-selinux-1.3.2-1 katello-selinux-1.3.1-1 katello-selinux-1.1.2-1 katello-selinux-1.1.1-1 katello-selinux-1.0.1-1 katello-selinux-0.2.7-1 katello-selinux-0.2.6-1 katello-selinux-0.2.5-1 katello-selinux-0.2.4-1 katello-selinux-0.2.3-1 katello-selinux-0.2.2-1 katello-selinux-0.2.1-1 katello-selinux-0.1.10-1 katello-selinux-0.1.9-1 katello-selinux-0.1.8-1 katello-selinux-0.1.7-1 katello-selinux-0.1.6-1 katello-selinux-0.1.5-3 katello-selinux-0.1.5-2 katello-selinux-0.1.5-1 katello-selinux-0.1.4-1 katello-selinux-0.1.3-1 katello-selinux-0.1.2-1 katello-repos-1.4.1-1 katello-repos-1.3.4-1 katello-repos-1.3.3-1 katello-repos-1.3.2-1 katello-repos-1.3.1-1 katello-repos-1.2.4-1 katello-repos-1.2.3-1 katello-repos-1.2.2-1 katello-repos-1.2.1-1 katello-repos-1.1.3-1 katello-repos-1.1.2-1 katello-repos-1.1.1-1 katello-repos-1.0.3-1 katello-repos-1.0.2-1 katello-repos-1.0.1-1 katello-repos-0.2.10-1 katello-repos-0.2.9-1 katello-repos-0.2.8-1 katello-repos-0.2.7-1 katello-repos-0.2.6-1 katello-repos-0.2.5-1
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.storybook Fixes #21931 - Add react-storybook to Katello Dec 12, 2017
.tx fix paths in .tx/config after git reorganization Apr 29, 2013
app Fixes #22370: use the new RH repos page instead of the old. Mar 20, 2018
bin Fixes #15035 - Adding rails script to katello (#6045) May 13, 2016
ca adding redhat-uep.pem to katello ca Oct 5, 2011
config Fixes #22370: use the new RH repos page instead of the old. Mar 20, 2018
db Fixes #22373 - Audit manifest import/refresh using Organization Mar 7, 2018
engines/bastion_katello Fixes #22919 - Modify the extract process to remove duplicates Mar 20, 2018
lib Fixes #22370: use the new RH repos page instead of the old. Mar 20, 2018
locale Fixes #22859 - Extract the latest strings from katello. Mar 16, 2018
spec Refs #20317 - use .id with find in test Dec 22, 2017
test Fixes #22939 - add setting for strict host re-register Mar 20, 2018
vendor Fixes #20544 - Make CSS assets findable to sprockets Aug 14, 2017
webpack Fixes #22370: use the new RH repos page instead of the old. Mar 20, 2018
.babelrc Fixes #21575 - Use hound to run eslint Nov 16, 2017
.eslintignore Fixes #21575 - Use hound to run eslint Nov 16, 2017
.eslintrc Fixes #21663 - Clean up RH Repos page Nov 21, 2017
.gitignore Fixes #22463 - Ignore locally cloned Foreman in tests Jan 31, 2018
.hound.yml Fixes #21575 - Use hound to run eslint Nov 16, 2017
.mention-bot Fixes #16924 - Add mention-bot config Oct 13, 2016
.rspec initial commit Jun 15, 2011
.rubocop.yml Fixes #22494 - Ignore any ruby in node_modules Feb 2, 2018
.rubocop_todo.yml Refs #20317 - stop using HttpPositionalArguments Dec 21, 2017
.simplecov Setup simplecov in katello Mar 5, 2013
CONTRIBUTING.md Fixes #15034 - Remove old scripts from katello (#6044) May 13, 2016
CONTRIBUTORS adding myself to contrib Jul 1, 2015
Gemfile Engine: Removing old gem files Dec 6, 2013
LICENSE.txt set Markdown as default markup Jan 16, 2013
README.md Fixes #21763: s/katello.org/theforeman.org/ README Dec 12, 2017
katello.gemspec Fixes #22701 - Bump foreman-tasks dependency Feb 27, 2018
package.json Fixes #22371, #22563 - Add pagination and filtering to RH repos Mar 15, 2018



Build Status Code Climate Dependency Status

Full documentation is at https://www.theforeman.org/plugins/katello/


Katello is a systems life cycle management plugin to Foreman. Katello allows you to manage thousands of machines with one click. Katello can pull content from remote repositories into isolated environments, and make subscriptions management a breeze.

Currently, it is able to handle Fedora and Red Hat Enterprise Linux based systems.


The most common way to set up Katello for development is to use katello-deploy. This will set up a Vagrant instance with the Katello codebase checked out. You can also run setup.rb directly with katello-deploy if you prefer to not use Vagrant.

There is also katello-devel-installer if you would like to use that.

If you have questions or issues with any of the above methods, feel free to ask for assistance on #theforeman-dev IRC channel or via the foreman-dev mailing list.

Test Run

At this point, the development environment should be completely setup and the Katello engine functionality available. To verify this, go to your Foreman checkout:

  1. Start the development server

    cd $GITDIR/foreman
    rails s
  2. Access Foreman in your browser (e.g. https://<hostname>/). Note that while Rails will listen on port 3000, the dev installer will set up a reverse proxy so HTTPS on port 443 will work.

  3. Login to Foreman (default: admin and changeme)

  4. If you go to https://<hostname>/about and view the "Plugins" tab, you should see a "Katello" plugin listed.

Reset Development Environment

In order to reset the development environment, all backend data and the database needs to be reset. To reiterate, the following will destroy all data in Pulp, Candlepin and your Foreman/Katello database. From the Foreman checkout run:

rake katello:reset

Found a bug?

That's rather unfortunate. But don't worry! We can help. Just file a bug in our project tracker.


See the developer documentation.

Annotated Pulp and Candlepin Workflows and test Scenarios

See the annotation docs for more information.

Contact & Resources


Most of our documentation (both for users and developers) can be found at theforeman.org.