How to Install Elgg CMS

Elgg is a social networking framework. It provides the necessary functionality to allow you to run your own social networking site, whether publicly (like Facebook) or internally on a networked intranet (like Microsoft Sharepoint).

Installing Elgg

Before you begin, make sure you have read Elgg's technical requirements. If you discover problems after following these instructions, check out the troubleshooting page. For detailed, step-by-step instructions for different types of local server environments (could be your home computer), see the operating specific instructions at the bottom of the page.

1. Upload Elgg

• Download the latest version of Elgg to your computer and then unzip it.
• On the webserver, you can store elgg in one of two ways:
  • In its own directory (i.e. /home/www/elgg)
  • In the document root (i.e. /home/www)
• Upload the files with an FTP client to your web server.

2. Create a data folder

Elgg needs a special folder to store uploaded files including profile icons and photos. You will need to create this directory.
We recommend that this folder be called "data". For security reasons, this folder must be stored outside of your document root. For example, if Elgg is installed in:

 /home/www/elgg/

You might want to create the data folder in:

 /home/www/data

Alternately, if Elgg is installed in:

 /home/username/public_html/

then you may want to create it in:

 /home/username/data/

Once this folder has been created, you'll need to make sure the web server Elgg is running on has permission to write to and create directories in it. This shouldn't be a problem on Windows-based servers, but if your server runs Linux, Mac OS X or a UNIX variant, you'll need to set the permissions on the directory.
If you are using a graphical FTP client to upload files, you can usually set permissions by right clicking on the folder and selecting 'properties' or 'Get Info'.
NOTE: Setting your data directory to 777 will work, but it is insecure and is not recommended. If you are unsure how to correctly set permissions, read this documentation or contact your host for more information.

3. Create a MySQL database

Using your database administration tool of choice (if you're unsure about this, ask your system administrator), create a new MySQL database for Elgg. You can create a MySQL database with any of the following tools:

• cPanel
• phpMyAdmin
• MySQL commandline client

Make sure you add a user to the database with all privileges and record the database name, username and password. You will need this information when installing Elgg.

4. Visit your Elgg site

Once you've performed these steps, visit your Elgg site in your web browser. Elgg will take you through the rest of the installation process from there. The first account that you create at the end of the installation process will be an administrator account.

A note on settings.php and .htaccess

The Elgg installer will try and create two files for you:

• engine/settings.php, which contains the database settings for your installation
• .htaccess, which allows Elgg to generate dynamic URLs

If these files can't be automatically generated, for example because the web server doesn't have write permissions in the directories, Elgg will tell you how to create them. You could also temporarily change the permissions on the root directory and the engine directory. Set the permissions on those two directories so that the web server can write those two files, complete the install process, and them change the permissions back to their original settings. If, for some reason, this won't work, you will need to:

• Copy engine/settings.example.php to engine/settings.php, open it up in a text editor and fill in your database details
• Copy /htaccess_dist to /.htaccess

Note for installation on a virtual host (e.g. Rackspace, Amazon EC2)
For installation to proceed successfully, modify the .htaccess file in the root, and uncomment:

117: #RewriteBase /

To be:

117: RewriteBase /

XAMPP Installation for Windows

• If you want to test your Elgg installation on your local computer running Windows

• Best run as a development/test server

1 - Download and install XAMPP to your computer from http://www.apachefriends.org/en/xampp.html - we'll assume you installed it on the C drive
2 - Once the installation is completed, it will prompt you to start the XAMPP controller panel. Leave it for now.
3 - Open C:\xampp\apache\conf\httpd.conf file with notepad and find the line "#LoadModule rewrite_module modules/mod_rewrite.so" and remove the "#" and save it.
4 - Edit the php.ini file and change arg_separator.output = & to arg_separator.output = &
5 - Now go to C:\xampp and double click on the xampp_start application
6 - Then go to http://localhost/
7 - Change your server's password in the security option
8 - Go to http://localhost/phpmyadmin and login with the username and the password of your server
9 - Create a database called "elgg" in your phpmyadmin panel
10 - Now download Elgg. Unzip it and extract to C:\Xampp\htdocs\sites\elgg
11 - Create the Elgg data folder as C:\Xampp\htdocs\sites\data
12 - Go to http://localhost/sites/elgg
13 - You will be taken to the Elgg installation steps. Install it and enjoy.