Documentation

So we've been talking seemingly forever about possible queuing system instead of our crappy "PHP/Vixie Cron based" one, but we have yet to document pro/cons of possible alternatives. Here are the goods (or the beginning of em).

Aegir install on OSX Snow Leopard

Aegir install instructions are fantastic if you run Debian/Ubuntu Linux. Some of the steps for OS X are a quite different

I've attached some more detailed instructions on how to install Aegir on CentOS.

The instructions may not be 100% perfect, but I'm due to install Aegir on CentOS again next week, which should given me an opportunity to fine-tune the instructions further.

I've had no trouble setting up a multi-webserver setup as well. If you're trying it yourself and get stuck, ping me on IRC (resonancedev in #aegir) or post a comment.

This page, like all our documentation, is a Wiki - please feel free to add and edit.

The Aegir project is growing rapidly, and more and more people are installing and testing the code. Many users ask about how to help out and give something back to the project - so that's what this page is about.

Finding and Reporting Bugs

So you've found a bug? Although bugs obviously aren't good, in a complex project like this they're bound to exist - so it's brilliant you found it. Now we'd really like your assistance to help us fix it.

Here's how:

This page is just intended to be for the development team to make notes about needed documentation for the project. It's a scratchpad for notes, thoughts etc.

Existing Documentation to revise (perhaps because the code has changed):

Features Yet to be documented:

Troubleshooter tips to write up:

FAQs to write up:

In some situations you may wish to allow different people access to Aegir, but restrict which sites they can manage.

• Use Case 1:

  As a developer you may simply wish to segregate your sites in Aegir by different clients for your own internal management reasons.

• Use Case 2:

  If you have many staff working on different projects, you may wish to issue them with different logins and restrict which sites they can access on the Aegir system.

• Use Case 3:

So we have switched to using Git to work on aegir.

There may come a time when you want to remove a website from your Aegir powered server. As you'd expect, Aegir handles this for you too. It'll even clean up after the site properly

But resist the first temptation of someone used to working with Drupal's nodes - don't go to the site's node, select the edit tab and press the 'delete' button! (in coming releases of Aegir this is to be made clearer).

Here's the proper way to do it:

1. Disable the Site

WARNING: outdated instructions

those instructions are not the canonical install instructions and are outdated. You should follow the canonical instructions in INSTALL.txt from now on (which include the use of a more resilient, multiplatform and generic install script.

The rest of this document is kept for posterity.

The manual installation instructions on this page assume that you have followed the steps in Preparing a Server for Aegir. You may need to change some elements of these instructions to fit your own servers setup.
You can also follow the instructions in the INSTALL.TXT file that is packaged with the Hostmaster installation profile.