This site is a static archive of the Aegir community site. Documentation has moved to Other community resources can be found on the Contacting the community page.
Skip navigation

Developer Manual


Developer Manual


This section of the documentation is aimed at developers interested in the Aegir project.

We use Git as a version control system for managing the project code, so we have specific instructions on how to use git.

Developers wishing to collaborate directly with the core team will want to read the release engineering guide.

Developers working on third-party modules should read the guide to extend Aegir and the API documentation.

Developers interested in developing on, for or with Aegir might be interested in Aegir-up, which provides a fully installed and configured virtual machine on Virtualbox/Vagrant. The Puppet module on which it is based supports an $aegir_dev_build option, that will install Provision and Hostmaster from the git repos, preserving the .git repos.

Need help?


The notebook section provides a way for you to store and share information with your group members. With the book feature you can:

  • Add book pages and organize them hierarchically into different books.
  • Attach files to pages to share them with others.
  • Track changes that others have made and revert changes as necessary.
  • Archive books that are no longer of interest to the group. Archived books can be reactivated later if needed.