community.aegirproject.org

Debian packages have been uploaded to http://debian.koumbit.net/, currently in the "unstable" distribution during the test period. We eventually want to upload those packages to the official archives, but this will take some adaptation and time to sponsor the packages in.

These are the installation instructions that are recommended on Debian. If you wish to install Debian packages over an existing manual install, it's possible. See the Debian upgrade procedures.

1. Adding the Koumbit repositories

Add the following line to /etc/apt/sources.list.d/koumbit-stable.list:

2. Adding the archive key to your keyring

This archive self-signs packages uploaded to it (and packages uploaded are verified against a whitelist of trusted uploaders) using OpenPGP (GnuPG, to be more precise).

The key of the archive is in the key.asc file. You should add the key using something like this:

3. Adding backports for or manually installing Drush

You should also configure backports repositories for Drush. Version 4.4 of Drush is now in Debian unstable, wheezy, squeeze-backports and Ubuntu Natty.

So if you are running Debian wheezy or later, or Ubuntu Natty 11.04 or later, you don't need to do anything here. The Drush package you need is available from your distribution's repositories.

If you are running Debian Squeeze 6.0, add the following line to /etc/apt/sources.list :

You might also have to add a proper Pin-Priority to /etc/apt/preferences before this works:

If you are running Debian lenny 5.0 or Ubuntu Maverick 10.10 or Karmic Koala or earlier, we recommend downloading and installing the Drush package manually. The version of Drush in the Ubuntu Universe repository for these versions of Ubuntu is outdated. If you are using Ubuntu Lucid LTS 10.04, you can install the Drush package manually or instead use Brian Mercer's PPA (Personal Package Archive) using the following command:

4. DNS configuration

Aegir requires a properly configured "FQDN" (Fully Qualified Domain Name) be assigned to the machine. In practice, this means that the hostname returned by the hostname and uname -n shell commands should resolve to the IP address for this server, and vice versa, with the resolveip command.

5. Manual sudo configuration

If you are running sudo versions previous to 1.7.2p1-1 (in Debian squeeze and Ubuntu Lucid), you will need to manually modify your /etc/sudoers file to add the following line:

The line above assumes that you have created a user aegir as specified in the installation instructions.

6. Installing Aegir

To install aegir, frontend and backend, use the following command:

If apt-get reports that the aegir packages have unmet dependencies, then make sure that you have installed Drush (as explained above). On a debian system, you can force the install of Drush from the squeeze-backports repository:

Then install aegir using the apt-get command above.

This will prompt you for the required information and go ahead with the install.

7. Troubleshooting the install

To make the install smoother, the install command is run without much debugging information, which can make diagnostics pretty hard. For this, there's a special environment variable you can set that will trigger debugging output. Install aegir with this:

You can build your own Debian packages from our repositories using those instructions.