Page History

...

unzip blesta-vx.x.x.zip

3. Apply Hotfix Files (if necessary)

The Blesta files are available in the /blesta/ directory. These are the files you should use by default. However, it may be necessary to overwrite some of them with a set from a hotfix directory.

The files from a hotfix directory need to be applied if you are running an older version of the ionCube loader, or an older version of PHP. The following criteria will help you to determine what hotfix directory to use to overwrite your Blesta files with prior to installation.

A hotfix is necessary if your ionCube loader is older than v10.1.0:

• ionCube version >= 10.1.0 - no hotfix needs to be applied. Skip to step 4.
• ionCube version < 10.1.0 - a hotfix needs to be applied

If a hotfix needs to be applied, the correct hotfix to use depends on your version of PHP:

• PHP version >= 7.1.0 - use /hotfix-php71/blesta/ 
• PHP version >= 5.6.0 and < 7.1.0 - use /hotfix-php7/blesta/
• PHP version >= 5.4.0 and < 5.6.0 - use /hotfix-php54/blesta/

Apply the hotfix by overwriting the contents of the /blesta/ directory with the contents of the hotfix directory (e.g. /hotfix-php71/blesta/).

4. Upload Files & Launch Installer

Upload the contents of the /blesta/ directory to your server where you will be accessing Blesta. Before you continue any further, ensure you've created a database that Blesta can be installed into. You'll need your database host (usually localhost), database name, database user, and database user password to continue with installation.

...

1. In a shell, cd to the directory you uploaded the contents of blesta.
2. The CLI installer can be run in interactive mode, or non-interactive mode by passing parameters.

   1. For interactive mode run 

      Code Block
      php ./index.php install

      
      

      Info
      title Root Web Directory Setting
      If Blesta is not installed in the document root on your web server, it is important to note that the "Root Web Directory" setting will be inaccurate unless you install Blesta while your current working directory is set to the document root: Code Block title Installing from the web server's document root cd /to/your/web/server/document/root/ php ./path/to/blesta/index.php install

      
      

   2. For automatic mode run

      Code Block
      php ./index.php install -dbhost DATABASE_HOST -dbname DATABASE_NAME -dbuser DATABASE_USER -dbpass DATABASE_PASS -hostname WEBSITE_HOSTNAME -docroot DOCUMENT_ROOT_PATH

      
      

      Parameter	Description
      -dbhost	The database hostname (usually localhost)
      -dbname	The database name
      -dbuser	The database user
      -dbpass	The database password
      -hostname	The website hostname. For example, billing.domain.com. The is the hostname where Blesta will be accessed from. If not set, will attempt to detect the hostname from server configuration, which in many cases will not be accurate.
      -docroot	The full absolute path to the web server's document root (e.g. /var/www/html/). This should not be set to Blesta's installed directory unless Blesta is installed in document root. If this value is not set, it will be set based on your current working directory, which will not be accurate unless the current working directory is the document root. Info title Option added in v4.6.0 This value can be changed from within Blesta, after installation, under Settings > System > General > "Root Web Directory".

      
      

3. Once installation completes, direct your web browser to https://yourdomain.com/path_to_blesta/admin/ to create your administrator user and enter your license key or start a free trial.

...

...

5. Set up a Cron Job

Once installation is complete, a cron job must be created to automate tasks within Blesta. Go to [Settings] > [System] > Automation, and copy the "Cron Command", for use in creating a cron job on your server. Most hosting control panels provide an easy way to create cron jobs, follow the documentation for your control panel to complete this important step. The cron job should run every 5 minutes. Once the cron has been configured, verify that the status icon turns green and displays the last time run on the System Automation page within Blesta.

...