Katello is a plugin for Foreman that orchestrates content distribution and subscription management at scale across thousands of Enterprise Linux and Debian-based systems. Katello serves as an enterprise content gateway between external repositories and Foreman-managed hosts by synchronizing RPMs, container images, flatpaks, and more into versioned Content Views, promoting this content through isolated Lifecycle Environments. Katello provides Foreman hosts with first-class content, subscription, and entitlement management.
Full user documentation is available at https://docs.theforeman.org/release/nightly/index-katello.html. Use the selection in the upper right to select your Foreman/Katello version.
That's rather unfortunate. But don't worry; we can help! Just file a bug in our project tracker.
Katello welcomes community contributions! We typically review community pull requests within a week. All pull requests are required to reference a valid Katello issue on Foreman's project tracker. Please view existing PRs to get a sense of our contribution standards.
To set up Katello for development, we recommend using forklift to set up a virtual machine with the Katello codebase checked out and pre-configured. Please use the forklift documentation found in the repository above for further information. Once your environment is checked out, view our developer quick reference guide for information on running your Katello development server.
Please see our development guidelines. Katello source follows the following style guidelines:
If you have questions about or issues with deploying a development environment, feel free to ask for assistance in our matrix channel or our community forum
See the annotation docs for more information.