Written Installation Instructions>>

Here are installation instructions. These are for people already comfortable with performing database installations on LAPP (or LAMP) ISPs.

Note: Different ISPs use different configurations which may require variations from these installation instructions.

1. Set up the Postgres database on your ISP
   1. Login to cPanel with your cPanel user (ie linuxusr) at your Linux based web host with Postgres.
   2. Create a Postgres database on your web server using cPanel, for example named linuxusr_sampledb.
   3. Create a Postgres user (ie linuxusr_dbuser) and assign this user to your database.
   4. Login to phpPgAdmin using your cPanel login (ie linuxusr).
   5. Issue this SQL statement in the query window to install the plpgsql language in your database (linuxusr_sampledb).

      CREATE LANGUAGE plpgsql;

      Note: This statement must be issued by the owner of the database which is the cPanel user by default for most ISPs. However, for security reasons you do not want to run Brimbox under your cPanel login so you need to create a database user.

2. Install Brimbox in your web folder
   1. Unzip brimbox_core_vX.X.X.zip on your desktop. It should unzip to the folder core. Change this folder name if desired to yourfolder.
   2. Open bb_config.php in subfolder bb-config using a text editor and fill in your database details

      DB_HOST is usually localhost
      DB_NAME is your postgres database name (ie linuxusr_sampledb)
      DB_USER is your postgres database user name (ie linuxusr_dbuser)
      DB_OWNER is your postgres database owner name (ie linuxusr)
      DB_PASSWORD is your postgres database user password (not your cPanel login)
      

   3. DO NOT change the EMAIL settings as these take a little configuring and can be done later.
   4. Open .htaccess in the root folder using a text editor and substitute your folder name if desired for the default folder core in these lines. You can install to directory core without making changes to the .htaccess file.

      RewriteBase /yourfolder/
RewriteRule . /yourfolder/index.php [L]

      Or if you are installing in a root domain.

      RewriteBase /
RewriteRule . /index.php [L]

      Since Brimbox should be running over https this is a SSL .htaccess file for the subdirectory core.

      RewriteEngine On
RewriteCond %{SERVER_PORT} !=443
RewriteRule ^(.*)$ https://www.yourdomain.com/core/$1 [R,L]
RewriteBase /core/
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /core/index.php [L]

   5. Upload the Brimbox files to the desired location on your web server (make sure this is a binary upload, an ascii upload will alter the images):
      1. If you want to have your Brimbox installation in its own subdirectory on your web site (e.g. http:// www.yourdomain.com/yourfolder/) move or upload all contents of the unzipped Brimbox directory (excluding the directory itself) to the subdirectory yourfolder. Your database home will be http://www.yourdomain.com/yourfolder/
      2. If you want to integrate Brimbox into the root of your domain (e.g. http:// www.yourdomain.com/), move or upload all contents of the unzipped Brimbox directory (excluding the directory itself) into the root directory of your web server. Your database home will be http://www.yourdomain.com/.
      3. You could also set up a subdomain.
   6. Run the Brimbox installation script by accessing dbinstall.php in a web browser.
      1. If you installed Brimbox in its own subdirectory called yourfolder, for example, you should visit: http://www.yourdomain.com/yourfolder/dbinstall.php.
      2. If you installed Brimbox in the root directory, you should visit: http://www. yourdomain.com/dbinstall.php

       
      

3. WAIT!!! You need to change the Brimbox admin password immediately.
   1. You should login and promptly change the password for the generic Brimbox “admin” user on the “Admin” tab of Brimbox interface. Go to http://www.yourdomain.com/ or http://www.yourdomain.com/yourfolder/ if you installed under a folder, and login under user “admin” and password “password”. When you install a Brimbox database on your server a generic username “admin” and password “password” is issued so you can get into your database. You should go to the “Admin” tab and change that password in the module “Manage Users”, and add any users you want to the database.
   2. Then delete the database install file in your web folder (dbinstall.php). It is not needed anymore. You have successfully installed Brimbox.

Updated: 2016-07-25