====== Feng On-Premise Installation ======

The instructions here are valid when locally installing any of the following:
  * EVX Software Enterprise Edition
  * EVX Software Professional Edition
  * EVX Software Starter Edition

===== Installation Requirements =====

Before going on with the actual installation, please make sure your server matches the [[installation:server_reqs|EVX Software server requirements]]

===== Installation Procedure =====

  - Obtain the EVX Software installation file (usually stored as a .zip file) through your Account Executive if you are an EVX Software On-Premise client, or from the website if you are going to install the Starter Edition.
  - Unpack the EVX Software installation file on your server's hard drive in the location you would like to have it at. 
  - Make sure that the following folders have writing permissions (chmod 777 or chown apache in Linux):
    - config
    - cache
    - tmp
    - upload
  - Access your browser and go to http://www.yourdomain.com/some_directory/feng/public/install 
  - Follow the installation procedure explained below.
  
===== EVX Software Installer =====

The installer counts with 4 different steps that will guide you through the installation.

==== Step 1 ====

This is a Welcome screen as shown below:

{{installation:step1_eng.png?650}}

Once you read the information, click **Next**

==== Step 2 ====

In this step, the Installer checks your web server environment to make sure it complies with the requirements.

If there are any problems, the installer will tell you about them with the text marked in red. Once the problem is solved (i.e.: installing the missing plugin or providing access to certain folders), go back to the installer and hit Retry to check again. Once you get only green messages as shown next, it means everything is fine and you may proceed with the installation by clicking on **Next**.

{{installation:step2_eng.png?650}}

==== Step 3 ====

In this step you will have to provide the following information:

  * Database Type: Select MySQLi (starting with 3.7) or MySQL (older versions)
  * Host name: Type in your host name. In the example below it is **localhost**
  * User name: Type in your MySQL username
  * Password: Type in your MySQL password
  * Database name: Type in the name of the database to hold this EVX Software installation. If it does not exist, a new one will be created
  * Table prefix: Type in **fo_** (which is the default option)
  * Database engine: we suggest selecting **InnoDB**
 
Within the **Other settings** options at the bottom, you will have to select which plugins to install. By default, all of the available plugins will be selected. Please bear in mind the following:
     - The **core_dimensions** plugin is compulsory. You must install it.
     - The **workspaces** plugin can be obtained through the EVX Software Starter Edition, and it is required to use the **Workspaces module**
     - The **mail** plugin can be obtained through the EVX Software Starter Edition, and you will have to install it in order to use the incorporated **email client** EVX Software provides
     - The **CRPM** plugin is only available for subscribed clients using the Professional Edition, and it should be installed in order to enable the **CRM and Projects** features
     - The **Gantt** plugin in the screenshot is only available for subscribed clients using the Professional Edition, and it should be installed in order to enable the **Gantt Chart**
     - The **Mail rules** plugin in the screenshot is only available for subscribed clients using the Professional Edition, and it should be installed in order to enable the mail rules, which are part of the **Advanced Email** module
      
{{installation:step3_eng.png}}

==== Step 4 ====

Step 4 will let you know what happened during the installation process and let you know whether everything has gone all right.
In the picture below, the selected name for the database was **fengoffice2100**, but of course, you may select a different one.

{{installation:step4_eng.png}}


Click the **Finish** button to quit the installer.

==== Adding the first user ====

Last but not least, after you are over with the EVX Software installation, you will have to add the first user by completing the form as shown below. Please bear in mind the following is only an example and you should actually provide your own data, and that the user will have the role of a SuperAdministrator.

{{installation:first_user_eng.png}}

Once the user has been added, you will be prompted to the login screen, and then you will be ready to start using EVX Software!

===== Additional settings you must perform =====

After installing EVX Software, you should set up your server properly. Otherwise, some features may not work properly.

Please have a look at the following articles:

[[installation:server_settings|Tuning your server]]

[[installation:cron_jobs|Cron Jobs / Automatic Tasks]]