This is a typical WAMP/LAMP stack. All linux distributions have this natively so we recommend you install the packages from your distribution (make sure you have the right versions). On windows download the XAMPP stack from apache friends. You can see the list of application versions here.
Please make sure to review MySQL configuration (my.cnf or server start parameters)
ENGINE=InnoDB | Should be available. (Turn off –skip-innodb) |
Following extensions should be enabled for your PHP setup
GD | Mandatory | Charts and graphs generation are dependent on this library. |
IMAP | Mandatory | Webmails Module is dependent on this library. |
Zlib | Mandatory | Used for backups and module packaging among others |
DOM (php-xml) | Mandatory | New dependency For coreBOS Updater |
OpenSSL | Optional | Imap with OpenSSL should be enabled in case Mail server needs to be connected via SSL |
Curl | Optional | This one is optional but really important for any external communications, like SMS, Google Sync or RSS |
MBString | Optional | This one is optional but mandatory if you want to use GenDoc |
Make sure to verify if your PHP configuration meets the recommended values.
Variable | Value |
---|---|
allow_call_time_pass_reference | on |
error_reporting | E_ERROR |
safe_mode | off |
display_errors | on |
file_uploads | on |
max_execution_time | 600 |
max_input_vars | 6000 |
post_max_size | 36M |
memory_limit | 1024M |
log_errors | off |
output_buffering | on |
register_globals | off |
request_order | GP |
The maximum size of file uploads is defined by the PHP upload_max_filesize directive. Remember to set this variable to accommodate the file size you need to upload. coreBOS has a Global Variable that can limit the upload BELOW this directive, never above, PHP defines the maximum limit.
I normally set this variable to 32Mb
If you have the PHP Suhosin extension installed, this extension adds restrictions to make PHP more secure, but some of these restrictions break coreBOS.
To solve this problem you must change two variables in the suhosin config file: (normally: /etc/php5/conf/suhosin.ini)
suhosin.post.max_vars = 8000 suhosin.request.max_vars = 8000
After this, you must restart your apache server.
For security reasons it is VERY important that you set the value of request_order to GP.
coreBOS barely uses cookies and it does not look for them in the $_REQUEST superglobal.
Most modern linux servers already set this value to GP by default so you are probably already covered but check just in case.
You can read a little more about this here.
Provide read-write access to the following files and folder (recursively):
Read and Write permissions should be enabled for user/group who owns webserver process (like www-data or httpd or apache).
Please make sure you meet all these requirements
If the database exists it MUST be empty, the install procedure DOES NOT migrate, there is a migration procedure available if necessary.
For additional security it is recommended that you take two more steps:
Now comes all the fun
XAMMP configures your PHP to load files only from a couple of directories. By default it does not look for files in the current directory which is something that coreBOS depends upon. You must edit your php.ini file, look for the include_path directive and add the current directory. Something like this;
include_path = ".;C:\php\pear;C:\wamp\www"
What I usually do when I have to install on windows is edit config.inc.php and add this line towards the end:
echo get_include_path();
then I edit the php.ini directive putting the same value and adding the current directory (.)
apply this change in my.cnf
max_allowed_packet = 16M