Aegir hosting system
Documentation
(PLEASE NOTE: This is a wiki page so you can edit it if you are logged into and part of the group.)
Aegir is a powerful system that sits on a LAMP server to create, deploy and manage Drupal sites. Once installed you can setup a drupal site in a few clicks - with Aegir setting up the apache config files and the MySQL database.
Aegir is in development, but is stable enough that many are already using the Release Candidates in production environments.
This documentation will tell you what you need to know to get Aegir setup and running.
Installing Aegir
The documentation is meant to work "everywhere". INSTALL.txt features examples for Debian but should be comprehensible to any administrator with minimal experience. HINTS files are also now provided as quicker install instructions for other platforms than Debian.
If you encounter problems during the install, see if the issue already has been reported and if not, report the issue. We are committed to keeping the install instructions as clean and platform-independent as possible, but for this we need wide testing and proper bug reports.
0.3 stable release
- Debian-based instructions (the canonical INSTALL.txt instructions, that should work everywhere)
There's also an unsupported shell script to automate the install on Debian.
Development version
- Generic, Debian-based instructions (the canonical INSTALL.txt instructions)
- CentOS instructions (should also work on RHEL)
- If you have a platform not featured above, follow INSTALL.txt and submit a HINTS file similar to the CentOS one above.
As part of the install process, you will require the use of install.sh near the end of the install to deploy the required modules and packages. The install.sh is platform-agnostic.
Using Aegir
-
Aegir is installed - what next?
a. Setting up a 'Platform'
b. Import an Existing Website
c. Setup a new Website
d. DNS Wildcard configuration
e. Migrate / Upgrade Websites
f. Delete a Website -
Advanced Features
a. Multi-user access control with the 'Clients' Feature
b. Setting up HTTPS for Aegir managed sites
c. Configuring Multiple Web Servers
e. Manually move sites between servers
Upgrading Aegir
The upgrade instructions are kept up to date in UPGRADE.txt.
FAQ
If you have trouble or have questions about Aegir, please see if your question wasn't already answered in the FAQ.
Troubleshooting
More here soon. For now see the bug reporting guidelines.
Getting Involved
Finding bugs, testing patches and helping out
Developer Documentation
Git access to the code
Release process
Design documents
Getting Help
The Issue Queue for all the projects that make up Aegir is here: http://ln-s.net/3IJ+
This is the first place to look - chances are someone's had the same problem as you before, and you'll get the quickest answers by searching for what they discovered.
Before asking a question or reporting an issue, you should read the bug reporting guidelines.
You can join the #aegir channel at Freenode on IRC. (IRC instructions for drupal users are at: http://drupal.org/irc). It's a friendly community, but a small one, so ask nicely and be patient!
Outdated documentation
This documentation was produced in early releases and no longer applies.
- Manual Installation: a/ Preparing a server for Aegir (applies only to 0.3, and doesn't work anymore)
- Manual Installation: b/ Install Aegir (applies only to 0.3, and doesn't work anymore)
- Auto Installation: Install Aegir Using the Shell Install Script (applies only to 0.3, and doesn't work anymore)
- Installing Aegir - The Movie! (ext. link)(outdated: only relevant to 0.2)
Some users have posted their experiences and tips for installing Aegir on specific systems:
* RedHat EL: http://groups.drupal.org/node/20433
* CentOS 5: http://groups.drupal.org/node/19170
Credits
Aegir's main developers are adrian (Vertice), anarcat and mig5.
Other contributors are:
Documentation by: steveparks (pilot)
