Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Katello integrates open source systems management tools into a single solution for controlling the lifecycle of your machines.
Ruby JavaScript HTML CSS Other
branch: master

Merge pull request #5252 from parthaa/fix-protected

Fixes #10620 - Repos no longer protected by default
latest commit 3f973656ce
@parthaa parthaa authored
Failed to load latest commit information.
.tx fix paths in .tx/config after git reorganization
app Merge pull request #5252 from parthaa/fix-protected
ca adding redhat-uep.pem to katello ca
config fixes #10569 - convert products to scoped search
db Merge pull request #5188 from ehelms/fixes-8692
deploy Merge pull request #5237 from stbenjam/stbenjam--
doc Fixes #6870/BZ1075523: use ANONYMOUS_ADMIN for hidden user.
engines/bastion_katello Merge pull request #5216 from cfouant/cv-promotion
lib Merge pull request #5198 from waldenraines/10308
locale Fixes #5659 - String Extract
public Bastion: Adding base inline edit directives and adding them to system…
rel-eng Refs #10224 - release python-isodate for fedoras
script Fixes #10388 - Removing license header from remaining files
spec fixes #10569 - convert products to scoped search
test Merge pull request #5252 from parthaa/fix-protected
vendor Fixes #10227: remove tipsy to fix tooltip issues, BZ 1213556.
yard-template/default link filenames in module/class doc to github
.gitignore Fix apipie static generation on RPM build time
.rspec initial commit
.rubocop.yml Refs #9099 - Update rubocop to 0.28
.rubocop_todo.yml fixes #6781 - provide a way to restart capsule services
.simplecov Setup simplecov in katello
.yardopts Add documentation of db schema Refs #7242: Add 1.5-2.0 Changelog. Fixes #6272/BZ1118479 - move Bastion guide to
CONTRIBUTORS Fixes #7341: Adds script to generate contributors with initial list.
Gemfile Engine: Removing old gem files
LICENSE.txt set Markdown as default markup Fixes #6297 - delayed jobs is dead, long live foreman-tasks
katello.gemspec Fixes #9327: Update to Bastion 1.X and fix for eslint.
rubygem-katello.spec Fixes #9327: Update to Bastion 1.X and fix for eslint.

Katello Dependency Status

Full documentation is at


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 recommended way to set up Katello for development to use the katello-devel-installer directly or via katello-deploy.

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. http://<hostname>:3000/)

  3. Login to Foreman (default: admin and changeme)
  4. Create an initial Foreman organization
  5. Navigate to the Katello engine (e.g. http://<hostname>:3000/katello)

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 getting involved.

Contact & Resources


Documentation is generated with YARD and hosted at This documentation is intended for developers, user documentation can be found on wiki. Developer documentation contains:

  • code documentation
  • high level guides to architectures and implementation details
  • how-tos

Note: older developer guides can be found on our wiki, they are being migrated.

How to

Current documentation

  • {file:doc/}
  • {file:doc/}


  • {file:doc/how_to/ Enabling Praise} - raise/exception investigation


  • {file:doc/how_to/ How to package new gem}


  • {file:doc/katellodb.html DB schema documentation}
  • Original Rails generated README {file:doc/RailsReadme}, we may do certain things differently

    • we use doc directory for storing markdown guides instead of a generated documentation


  • {Katello::Configuration}
  • {Notifications}
Something went wrong with that request. Please try again.