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

Revision of Installing Aegir from Sun, 02/27/2011 - 02:46

Help

Installing Aegir

Tagged:

Because Aegir is a powerful system that requires some low-level management or configuration of your server, there are a few steps to complete the installation that go beyond what you'd normally be required to do to install a standard Drupal site.

For the same reason, Aegir doesn't support being run on a shared hosting environment where much of those low-level systems and tools are unavailable. Consult the System requirements to ensure you meet the necessary requirements for installing Aegir.

Warning: this documentation is being re-written to bring all the documentation from the source code (INSTALL.txt and so on) directly into this manual, so those documents may change and fluctuate over time. See this post for progress reports.

INSTALL.txt

Each release of Aegir contains an INSTALL.txt, which is the canonical source of installation instructions. It is kept in each release so that it may be versioned, as some installation steps may differ between releases.

The INSTALL.txt is modified for every release. For this reason, the easiest way to fetch the INSTALL.txt is to read the release notes for that release. The front page of this site always contains a link to the latest release notes.

Alternatively, you can find the release notes announced on our mailing-list.

The INSTALL.txt contains instructions tailored towards Debian or Debian-based systems such as Ubuntu. However, there are HINTS_(os).txt files located alongside the INSTALL.txt specific to various operating systems or Linux distributions that require diverging from the main instructions.

It is recommended that you follow the INSTALL.txt, and refer to the relevant HINTS file if necessary.

If you are running an operating system or Linux distribution that does not have a HINTS file, and diverges from the canonical INSTALL.txt, please submit a feature request to the Issue queue, attach your HINTS.txt, and mark the ticket for review.

The INSTALL.txt deals with satisfying system-level dependencies (such as LAMP/LEMP and other components) required for running Aegir, as well as setting up a system 'aegir' account on your server, which is tasked with performing much of Aegir's functions under the hood.

It also prepares the relevant LAMP or LEMP components for including the necessary Aegir-managed configuration areas (such as where vhost files are stored, listening on the appropriate network interfaces, and so on).

Method 1 - run the install.sh script

Once you have configured the system requirements outlined in the INSTALL.txt, you can download the install.sh script, which is an automated platform-agnostic shell script that performs the installation and configuration of the actual Aegir components.

At the completion of the script, a one-time login link is printed allowing you to login to your Aegir frontend for the first time. A welcome e-mail containing the same one-time login link is sent to the e-mail address of the main user account.

Method 2 - install the backend and invoke hostmaster-install

Experienced users are encouraged to download Drush and Provision manually and simply then run drush hostmaster-install. You will be prompted for various settings, unless you provide them on the command line with options to drush. These settings are:

  • 'aegir.example.com' (the domain to access your Aegir frontend via). This is a single argument, not a --switch
  • --aegir_host=FQDN (the FQDN of your server. This should be something that remote web servers can resolve, in order to talk back to the database server running on your Aegir master server if required)
  • --client_email=you@example.com (the e-mail address of the first user/client). It must be RFC compliant (cannot be someone@localhost), as Drupal 7 has such a restriction, and otherwise you would not be able to create Drupal 7 sites in Aegir.
Need help?

Documentation

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.

The revisions let you track differences between multiple versions of a post.