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 forklift. This will set up a virtual machine with the Katello codebase checked out. Please use the forklift documentation found in the repository for how to get started with forklift.
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 on freenode or via the community forum
At this point, the development environment should be completely setup and the Katello engine functionality available. To verify this, go to your Foreman checkout:
Start the development server
cd $GITDIR/foreman rails s
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.
Login to Foreman (default:
If you go to
https://<hostname>/aboutand 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:
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
- Discourse Forum
- Archived mailing lists:
- IRC Freenode: #theforeman-dev, #theforeman
Most of our documentation (both for users and developers) can be found at theforeman.org.