Debops Tools Save

Your Debian-based data center in a box

Project README

|debops_logo| DebOps <>_

|CII Best Practices|

Your Debian-based data center in a box

A collection of Ansible <>_ playbooks, scalable from one container to an entire data center.

DebOps is a framework ^^^^^^^^^^^^^^^^^^^^^

  • 117+ highly extensible roles with sane defaults
  • Tuned for production and works great for development
  • Built for modularity so extending it is simple
  • Custom scripts to tie everything together

We believe in the UNIX philosophy; one tool should only do one thing very well. DebOps has many playbooks and roles but it is just a set of focused tools to help you run and manage your infrastructure.

In fact all of the DebOps playbooks and roles can be ran with Ansible directly.

Installation ^^^^^^^^^^^^


DebOps requires a dependency that is not already installed by Ansible.
Install ``netaddr`` however you see fit:


   $ pip install netaddr
   $ apt-get install python-netaddr
   $ yum install python-netaddr

DebOps scripts

The easiest way to install DebOps is::

$ sudo pip install $ debops-update

If you want to have more control on the installation process, you can use::

$ git clone $ sudo pip install ./debops-tools $ debops-update

Please see the Installation Guide <>_ for more details.

Getting started ^^^^^^^^^^^^^^^

Here is a short intro how to use DebOps. Please have a look at the Getting Started Guide <>_ for more detailed information.

Make your first project


$ debops-init ~/myproject

Add a host to your inventory

Take a peek at ~/myproject/ansible/inventory/hosts.

Verify it


$ ssh yourhost $ debops-task all -m setup

Run the DebOps playbooks


$ debops

What do you want to learn more about? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^


  • Playbooks and roles <>_
  • Custom scripts <>_
  • DebOps guides and troubleshooting
    • Using linux containers <>_
    • Creating a local APT server to use backports <>_
    • Solving common problems <>_

Do you want to contribute? ^^^^^^^^^^^^^^^^^^^^^^^^^^

Sounds great, check out the contributing guide <>_ for the details.


**Maciej Delmanowski**

- Email: [email protected]
- Twitter: `@drybjed <>`_
- Github: `drybjed <>`_

**Nick Janetakis**

- Email: [email protected]
- Twitter: `@nickjanetakis <>`_
- Github: `nickjj <>`_

**Hartmut Goebel**

- Email: [email protected]
- Website:

**Robin `ypid` Schneider**

- Email: [email protected]
- Website:
- GitHub: `ypid <>`_

.. |Gratipay| image::
.. _Gratipay:
.. |debops_logo| image::

.. |CII Best Practices| image::

 Local Variables:
 mode: rst
 ispell-local-dictionary: "american"
Open Source Agenda is not affiliated with "Debops Tools" Project. README Source: debops/debops-tools
Open Issues
Last Commit
6 years ago

Open Source Agenda Badge

Open Source Agenda Rating