Your Debian-based data center in a box
The DebOps project is a set of Free and Open Source tools that let users bootstrap and manage an IT infrastructure based on Debian_ or Ubuntu_ operating systems. Ansible_ is used as the main configuration management platform. DebOps provides a :ref:`collection of Ansible roles <role_index>` that manage various services, as well as a set of Ansible playbooks that tie them together in a highly integrated environment.
Ansible roles and playbooks provided by DebOps can be used to manage a single host, a set of Debian or Ubuntu hosts, or an entire data center. The hosts in question can be physical or virtual machines, or even LXC/Docker containers.
Some of the applications and services supported in DebOps are:
- :ref:`X.509 certificate management <debops.pki>` with support for Let's Encrypt certificates
- a :ref:`git hosting platform <debops.gitlab>` based on GitLab
- :ref:`host and network monitoring <debops.librenms>` using LibreNMS
- :ref:`cloud file hosting <debops.owncloud>` based on Nextcloud or ownCloud
You can :ref:`try out DebOps <quick_start>` without installing it on your computer, using Docker or Vagrant. Alternatively, a set of scripts can be installed on your own computer, that will let you manage multiple, separate IT infrastructue environments.
The DebOps documentation is currently being reorganized, some of the sections might be empty or misleading. Ansible role documentation is current for the roles in the DebOps monorepo, the old project documentation is available at the end of the Table of Contents.
.. toctree:: :caption: Introduction :maxdepth: 1 :hidden: overview introduction/quick-start introduction/faq introduction/community introduction/philosophy introduction/timeline introduction/other-projects introduction/references
.. toctree:: :caption: News :maxdepth: 1 :hidden: news/releases news/changelog news/upgrades
.. toctree:: :caption: User Guide :maxdepth: 2 :hidden: user-guide/install user-guide/debops-for-ansible user-guide/project-directories user-guide/site-playbook user-guide/debops-cli user-guide/debops-config user-guide/bugs
.. toctree:: :caption: Admin Guide :maxdepth: 2 :hidden: admin-guide/bootstrap.rst admin-guide/common-config.rst admin-guide/dev-network.rst admin-guide/basic-virtualization.rst admin-guide/basic-mailserver.rst
.. toctree:: :caption: Developer Guide :maxdepth: 2 :hidden: dep/index developer-guide/development-model developer-guide/monorepo-layout developer-guide/code-standards developer-guide/software-sources developer-guide/debops-roadmap
.. toctree:: :caption: Tester Guide :maxdepth: 2 :hidden: tester-guide/test-methodology tester-guide/travis-ci tester-guide/gitlab-ci tester-guide/vagrant tester-guide/jane tester-guide/testinfra
.. toctree:: :caption: Ansible Roles :hidden: ansible/role-index ansible/roles/index
.. toctree:: :caption: DebOps API :maxdepth: 2 :hidden: debops-api/index
.. toctree:: :caption: Old documentation :maxdepth: 2 :glob: :hidden: debops-tools/index debops-playbooks/index debops-policy/index philosophy