Knowledge Base

How to install Elgg using the A2 QuickInstaller

This article describes how to use the A2 QuickInstaller to install Elgg on your server.

The A2 QuickInstaller is no longer supported, and is only available on older VPS hosting packages. On newer VPS hosting packages, you can use Webuzo to quickly and easily install a wide range of applications and manage your server.

To check if the A2 QuickInstaller supports this application for your Linux distribution, please see this article.

Installing Elgg

To install Elgg, follow these steps:

  1. Use SSH to log in to your system as the root user.
    To use the A2 QuickInstaller, you must log in as the root user using SSH. You cannot use the serial console in the VPS Control Panel to run the A2 QuickInstaller.
  2. To start the A2 QuickInstaller, type the following command, and then press ENTER:
    sh /usr/sbin/quickinstaller.sh
  3. Under Application Installers, type the option number for CMS/CRM, and then press ENTER.
  4. On the CMS/CRM Menu, type the option number for Elgg, and then press ENTER. The A2 QuickInstaller updates your server, and then begins the installation process.
    The installation process takes some time to complete. Do not interrupt the installation process.
  5. At the Please enter elgg database name prompt, type a name for the Elgg MySQL database, and then press ENTER.
  6. At the Please enter elgg database username prompt, type a username for the Elgg MySQL database, and then press ENTER.
  7. At the Please enter elgg database password prompt, type a password for the Elgg MySQL database user, and then press ENTER.
  8. When installation is complete, the A2 QuickInstaller provides configuration information about the Elgg installation.

Testing and configuring the Elgg installation

To test and configure the Elgg installation, follow these steps:

  1. Use your web browser to go to the following URL, where xxx.xxx.xxx.xxx represents your server's IP address:
    http://xxx.xxx.xxx.xxx/elgg
    The Elgg Welcome page appears.
  2. Click Next. The Requirements check page appears.
  3. Your server is already configured and should pass the requirements check, so click Next. The Database installation page appears.
  4. In the Database Username text box, type the database username that you provided in the previous procedure.
  5. In the Database Password text box, type the database password that you provided in the previous procedure.
  6. In the Database Name text box, type the database name that you provided in the previous procedure.
  7. Make sure that the Database Host text box is set to localhost.
  8. In the Database Table Prefix text box, use the automatically generated table prefix, or type your own.
  9. Click Next.
    If Elgg is unable to connect to the database, make sure that you typed the correct database name, user, and password, and then try again.
  10. On the Configure site page, type the name of your site in the Site Name text box.
  11. In the Site Email Address text box, type the e-mail address that Elgg uses to communicate with your users.
  12. The Elgg installer should fill in the Site URL and Elgg Install Directory text boxes automatically. Otherwise, type the paths that the A2 QuickInstaller provided at the end of the installation process.
  13. In the Data Directory text box, type the path to the directory where you want Elgg to save uploaded files. This directory must already exist and have the correct file permissions set.
    For more information about how to configure the Elgg data directory correctly and in a secure manner, please visit http://docs.elgg.org/wiki/Installation and http://docs.elgg.org/wiki/Data_directory.
  14. Select the default access level for new content in the Default Site Access list box.
  15. Click Next. The Create admin account page appears.
  16. In the Display Name text box, type the name that you want to appear for the site administrator.
  17. In the Email Address text box, type the e-mail address of the site administrator.
  18. In the Username text box, type the username of the site administrator.
  19. In the Password and Password Again text boxes, type the site administrator password.
  20. Click Next. The Finished page appears.
  21. To view your site, click Go to site.

More Information

To view the online documentation for Elgg, please visit http://docs.elgg.org/wiki/Main_Page.