We're rewriting our docs. This page has been ported to github. Join the effort!
Read this in French
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.
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:
You might want to create the data folder in:
Alternately, if Elgg is installed in:
then you may want to create it in:
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.
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:
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.
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.
The Elgg installer will try and create two files for you:
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:
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 /
117: RewriteBase /