e107 Wiki: English | Русский | Deutsch | Français | Magyar | Português | Български | Česky | Nederlands | Ελληνικά | Italiano | Norske | Polska | Slovenščina | Español | Svenska | Translate: Wiki | Page
This is the most up to date information available on how to install the e107 Content Management System, and supercedes any general information included with a particular release.
In most cases the install should go smoothly providing you follow these instructions carefully. If you encounter problems please refer to the troubleshooting help and then check the installation/upgrade forum.
Before you start with e107 you can always watch a Video Install Tutorial to use it you need Flash Player installed and the sound turned ON Ignore the references to v0.7.x as the install procedure hasn't changed significantly.
There are also a whole range of video tutorials available at Spinning Planet including plugin and other core functionality etc.
Install e107 Video Demo
e107 Content Management System Requirements
e107 requires a web-server with:
Contact your host if you're not sure if you have these installed.
Note: MySQL version 4.1 or later is recommended - e107 up to version 0.7.11 will run on versions as old as 3.22 (except for a few lesser used functions). However later versions will require MySQL 4.1 or later and PHP 4.4 or later.
Ideally choose a host which supports mySQL 5.x and PHP 5.x, or is committed to doing so soon, since at some point in the future that will become the minimum requirement.
Please Note: that many of the free hosts (and some others) restrict (in some cases severely) functionality in ways which prevent e107 from operating properly.
Key problems with free hosts
Whilst e107 is advert free (banners etc. can be disabled) you may find some free or low cost hosting services insist you run their adverts to support the service so there is a trade off to be made there and you may have to pay for hosting to get it advertising free.
You're accessing this information via the Internet and nothing on the Internet is actually 'free'. Someone, somewhere, is paying for that privilege. Be it your employer, School, Parents or via advertising etc - so to get the Best from e107 be prepared to pay a few $, £'s or whatever currency you use to pay for a decent hosting service unless you have the equipment to host a web site yourself (see below).
Self-Hosting a Development Server
You can install a server at home or in your company intranet, for system development and upgrade testing.
You can also use AMP packages like
All of the above include php and Apache as a package but not necessarily the latest versions of each.
Some considerations for hosting a public web site accessible on your Home PC:-
See also: How can I install a running web server?
Database Setup Requirements
You will need your MySQL username and password, and a database for content storage. Don't worry if you only have one database, e107 is happy to share it's database with other applications. To avoid conflicts, tables are prefixed with e107_ but you can also choose your own prefix during the install procedure.
e107 Disk Space Minimum Requirements
A full e107 install requires approximately 10MB of disk space on your server, though it is recommended that plugins that you don't intend to use are not uploaded to the server. This is helpful in 3 ways - it constrains disk space usage, will have a performance impact and may help with security. You will probably need additional disk space for some of the site content - potentially a lot more space if you are uploading large documents, high-resolution photos, video clips and similar.
Uploading e107 Files To Your Webspace
e107 will happily run in your webserver root or in a sub-directory
After downloading the package, you need to upload the files to your server using an FTP client :
i. Uploading files one-by-one
This is the most popular procedure used, but not the most efficient (as upload error may occur and it takes a certain time to do it)
ii. Unzipping the package directly into your server
If you have the correct permissions on your server you can use an alternative (and much quicker) method to upload the files:
Installing a language pack to your e107
Many translations are available for this CMS and you may install as many languages on your site as you wish. Get them here !
Ensure that you use a language pack corresponding to the version of the e107 package you're using (otherwise, you may see messages of the form LAN_BANNER_XX instead of comprehensible text).
For More information on Language and internationalisation support:
e107 File Permissions
In order for e107 to work you need to configure the permissions of files and folders on your server. By default these should be correct based on the zip file, however you may need to change them.
e107 Core File Permissions
The following permissions need to be set to use e107 core (most of these will have already been set this way from your previous install if upgrading). You can do this with your FTP client or via your host's cPanel > File Manager interface.
Note: the file permissions required will vary somewhat according to the web server configuration (which may well be outside your control). '777' permissions is often required for write access but does not always work. On some host it is recommended to not chmod more than '755' for security reasons.
In most cases '755' is sufficient for directories containing executable files, and '644' for directories which have 'data' files - images, downloads and so on. Directories to which users may upload through e107 will generally require '777' or '755' permissions depending on your host.
In general, grant the minimum level of access necessary for your site to work.
e107 Core Plugins File Permissions
The following permissions will need to be set if you were using statistics in your 0.6xx site (if upgrading) or wish to use the new Statistic Logging plugin at some point in the future:
The following permissions will need to be set if you were using the links page in your 0.6xx site (if upgrading) or wish to use the new links page plugin at some point in the future:
The following permissions will need to be set if you were using Reviews/Articles or Content in your 0.6xx site (if upgrading) or wish to use the new Content Management plugin at some point in the future:
Running The e107 Installation Procedure
Now open your web browser and navigate to
Install e107 Step 1 - Set Installer Language
If all the files have been uploaded successfully, you will see the first page of the install script. Choose the language you wish to use during the procedure and click the button to continue.
Install e107 Step 2 - Pre-Install Tests
e107 will now carry out a series of tests to see if requirements are met and all files that need permissions set are ok to be written to.
If you get a warning about mySQL don't worry too much, some versions of mySQL don't return the correct version, or return nothing at all.
Click on the button to continue if all criteria have been met, or else repair the problem and retest.
Install e107 Step 3 - Database Configuration
Next you have to enter your mySQL details. Enter your server name (generally 'localhost'), username and password. If you don't know your username and/or password contact your webhosts.
Install e107 Step 4 - Database Config Test & Setup Main Admin Account
If all is well e107 should now connect to your mySQL database, if any error messages are shown return to the previous page and make sure you entered your details correctly.
Now you have to enter your main admin details.
Enter your username, password and email address, you can change your email address and password at a later stage but your username cannot be changed, so make sure you enter it correctly.
Install e107 Step 5 - Main Install Process
e107 will now create the e107 database tables and populate them with the settings you entered.
Install e107 Step 6 - Install Completion
If all is well, the last button will take you to your new website. There, all done, that wasn't too bad was it?!
Post Install Steps
There are one or two jobs to do once the install script has completed.
Securing Your Configuration File
You must now set the file permissions of the main e107_config.php file back to 0644:
Checking your Installation
You should now be able to log in to your new website using the login name and password which you set during installation.
Integrity Check ( All files passed ) Core files passed: 2194 7.78 mb Core files failed: none 0 b Integrity incalculable: 2 251 kb
(actual values may vary - the concern is that we require zero core files to have failed).
Enabling File Types for Upload
By default e107 is secured so that no files can be uploaded. You can control and enable the certain types of file you may wish to be uploaded to your e107 system. For maximum security these are set in a text file called filetypes.php, which is found in the e107_admin subdirectory.
A sample file e107_admin/filetypes_.php contains the most common file extensions typically uploaded. To allow uploads,
WARNING: You should not allow any files to be uploaded which contain executable code which could be used by attackers, such as: .html .txt .php .js .exe .bat Your site WILL be at risk by allowing upload of these files.
There are further configuration steps required in the Admin Area, see HOWTO:Enable File Uploads.
Accessing your new e107 Web Site
Simply enter the 'root URL' of your site into your web browser. If you have installed e107 in the base or root directory of your web space, this will just be your domain name. If you have installed e107 in a subdirectory, add that to the domain name.
You should see the 'welcome' screen, and can log in as administrator and start configuring your site.
Setting Your Website Preferences
Review your website preferences, this controls important aspects of your site information, security and behaviours.
Harden your e107 security
Read the recommendations in this article: How can I 'harden' or improve e107 security?
The next steps will depend to a great extent on what you want to do with your system. There are some 'core' features, which are always present. Then further functions are available as 'plugins' - modules which may be installed if required, and ignored otherwise. Additional plugins are available from various sources. The appearance of your site is determined by its 'theme' - a number are included with the standard distribution, many more can be downloaded from various theming sites, or you can create your own.
Whatever your needs, we suggest you take some time to explore the various admin menus and start to understand the wide range of features available to you.
If you have any problems once you have installed e107 look at HOWTO:Solve post install problems.
Install complete, where to go now? Begin Building your e107 Website.
Alternative: cPanel Script Install
It should be noted that this is not the preferred method - the script is often many versions behind the current release version, and thus cannot be relied upon if security flaws are discovered and fixed
Cpanel is a control panel very widely used in hosting. If the panel has Fantastico installed (a plug-in which has a script library), then the user can install their CMS without the need to even fill out what database name. The plug-in will create the Database for you, and make the installation.