Documentation overview

Welcome to DebOps! This page provides an overview of the documentation included in the project. In the online version, you can use the sidebar to switch between documentation sections.


The "Introduction" section contains information about getting DebOps up and running.

This includes a guide on getting started, installation instructions, and answers to commonly asked questions.

User Manual

This section contains documentation about the usage of DebOps. It is intended to be an exhaustive reference of all DebOps user-facing features.

It includes a guide to project directories, the ways DebOps builds on top of Ansible, the usage of the various debops scripts, as well as the documentation of DebOps' extensive collection of playbooks and roles.

Admin Recipes

Here you can find guides for an IT infrastructure managed by DebOps.

This section explains common properties of the hosts that are managed, and provides ways to configure various infrastructure elements.

Developer guide

This section focuses on DebOps project development.

It contains information about best practices involving Ansible coding style, how various applications should be installed, how DebOps code is validated and tested, and how to contribute to the project yourself.

The DebOps Project

This section covers anything related to the DebOps project itself.

Documentation of various application programming interfaces available in the DebOps project can be found here.

You can also read about what the goals and philosophy of the project are, and how to reach the community.


In this section you can read about recent changes in the project and stable releases. You can also find here information about manual upgrade steps needed to be done when switching to the next DebOps release.