FUEL CMS User Guide : Version 1.4

Installing FUEL CMS

FUEL CMS uses CodeIgniter. If you are familiar with installing CodeIgniter, then many of the following steps will seem familiar to you.

The following are steps to installing FUEL:

  1. Download the latest version from getfuelcms.com
  2. Place the downloaded folder onto your webserver. Note that the fuel/data_backup, fuel/install and fuel/scripts folders should be a folders inaccessible from the web if using .htaccess.
  3. Browse to the index page. You should see a page of similar instructions as below.
  4. Alter your Apache .htaccess file to the proper RewriteBase directory. The default is your web servers root directory. If you do not have mod_rewrite enabled you will need to change the $config['index_page'] from blank to 'index.php' in fuel/application/config/config.php
  5. Install the database by first creating the database in MySQL and then running the fuel/install/fuel_schema.sql file
  6. Configure the fuel/application/config/database.php file with the proper database connection settings (like with any other CodeIgniter database application)
  7. Change the $config['encryption_key'] found in the fuel/application/config/config.php file
  8. Make the following folders writable:
    • fuel/application/cache/
    • fuel/application/cache/dwoo/
    • fuel/application/cache/dwoo/compiled/
    • assets/images/

That's it!

Upgrading to 1.4

If you have a current installation and are wanting to upgrade, there are a few things to be aware of. FUEL 1.4 uses CodeIgniter 3.x which includes a number of changes, the most prominent being the capitalization of controller and model names. Additionally it is more strict on reporting errors. FUEL 1.4 includes a script to help automate most (and maybe all) of the updates that may be required in your own fuel/application and installed advanced module code. It is recommended you run the following command using a different branch to test:
php index.php fuel/installer/update

Certain modules may require their own configuration and database SQL files to be run. Please reference their own documentation in the user guide for additional install information.