Installation - LimeSurvey CE
From LimeSurvey Manual
Revision as of 16:05, 18 February 2020 by DenisChenu (Automatic testing (revert if not needed))
- 1 General
- 2 Make sure you can use LimeSurvey on your website
- 3 Download the LimeSurvey package
- 4 Unpack the LimeSurvey package
- 5 Collect information about your server
- 6 Upload the files to your web server
- 7 Set directory permissions
- 8 Create a database user
- 9 Run the installation script
- 10 Connect to the administration script for the first time
- 11 Further configuration
- 12 What if I have problems...
The LimeSurvey project provides two ways to install LimeSurvey:
- On your webserver:
In this case, just follow the instructions on this page starting with step 1.
- On your local Windows PC:
You usually only want to install LimeSurvey on your local PC if you want to create surveys locally (mainly for speed or development/test reasons) and upload them later to your live LimeSurvey installation on a web server. For this purpose, we have prepared a special LimeSurvey package which includes the web server, the database, the LimeSurvey application, and instructions how to install it.
Make sure you can use LimeSurvey on your website
Make sure your server meets the following additional requirements.
The minimum set of requirements:
- Minimum 250 MB disk space.
- MySQL 5.5.3 or later OR Microsoft SQL Server 2005 or later OR Postgres 9 or later.
- Minimum PHP 7 or later; however, we recommend PHP 7.0.0+ with the following modules/libraries enabled:
- mbstring (Multibyte String Functions) extension library.
- PDO database driver for MySQL (pdo_mysql or pdo_mysqli) or Postgres (pdo_pgsql) or MSSQL (pdo_sqlsrv for Windows and pdo_dblib for Linux).
- Also, we assume in general that all PHP default libraries are enabled
- openssl or mcrypt
- etc …
Optional PHP Extensions:
- GD-Library with FreeType support installed is needed for captchas, nice charts in statistics or to upload images via the HTML editor - see PHP GD-Library Extension documentation
- IMAP (pretty standard) is needed for the email bounce tracking system - see PHP IMAP Extension documentation
- LDAP installed is needed to import survey participants using LDAP - see PHP LDAP Documentation
- Zip (pretty standard) is needed for template upload, import of .zip archived resources, and excel export - see PHP Zip Extension documentation
- Zlib (pretty standard) is needed for the ComfortUpdate - see PHP Zlib Extension documentation
In most cases, your web server provider or system administrator will be able to help you out with these optional components.
If you want to run Microsoft's IIS server, taking a look at Installation on XP with IIS might also help.
We use Travis for some automatic testing. Our test was currently done with
- PHP version : 7.2, 7.3 and 7.4
- SQL version : MariaDB with MyIsam and InnoDB
You can check the exact version of PHP and SQL at https://travis-ci.org/LimeSurvey/LimeSurvey
We support any reasonable screen size for survey taking (360px x 640px and up). The minimum supported screen resolution for the LimeSurvey administration page is 1280px x 1024px.
Hosting for LimeSurvey
LimeSurvey should work with most hosting companies that provide PHP and MySQL. If you want a ready-installed version of LimeSurvey, you could try LimeSurvey Professional, else check out our list of LimeSurvey-compatible hosting companies.
Download the LimeSurvey package
Download the latest stable LimeSurvey zip package (there are also gzip, bz2 and 7zip packages available for your convenience) and save it to your local disk.
Unpack the LimeSurvey package
Uncompress the zip file into a dedicated directory/folder using your preferred compression software. When you uncompress the file make sure that you uncompress the directory structure with the files (this is default behavior for most compression programs). The path name for the installation directory should not include '(' or ')' special characters, but it may include the space character.
Collect information about your server
You will need to know the following things to install LimeSurvey on your web server correctly:
- Your intended website URL where your scripts will reside (e.g. http://my.domain.com/limesurvey).
- The physical disk location on your server where your scripts will reside (e.g. /home/usr/htdocs/limesurvey).
- The IP/net location of your database server (i.e. localhost).
- If your database server uses a non-standard port, find out which port it is.
- Your user name and password for your database server.
- With most providers you can't let the script create the database, but have to do it yourself. If you are using such a provider, please create a database (for example limesurvey) yourself.
Upload the files to your web server
Using your FTP program (e.g. FileZilla), connect to your web server and create a directory to store your scripts. Then upload the files using the directory structure they are in. Make sure you upload the files in binary mode (check the settings of your FTP program). Please note that uploading in ASCII mode can lead to uncommon errors (e.g. 'class not found' error during installation), also images may not be uploaded correctly.
Set directory permissions
For the script to work properly it needs certain access to some directories - this applies especially to Linux/*nix systems.
- The "/limesurvey/tmp" directory (and all its subdirectories and files) are used for imports & uploads and should be set to Read & Write for your webserver.
- The "/limesurvey/upload/" directory (and all its subdirectories and files) must also have Read & Write for your webserver in order to enable picture and media files upload.
- The "/limesurvey/application/config/" directory also needs Read & Write permissions for your webserver.
- The other directories can be set to Read Only. You may wish in Linux/Unix to set the permissions on each file within the /limesurvey/admin directory to Read Only.
Create a database user
LimeSurvey will create a database and the tables inside it. To be able to do this, it will need the user name and password of a database user. We generally recommend creating a database user with the following permissions:
- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX
- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER
- Microsoft SQL Server: Unknown - if you can find out this information, please complete it.
Run the installation script
Go to "example.org/limesurvey/admin". If you configured everything correctly, the LimeSurvey installer should be starting - just follow the instructions. You will be asked whether you wish to create the database and/or create the tables inside the database. LimeSurvey will then create the needed tables in the database.
Connect to the administration script for the first time
You are done when the installation finishes! Open your browser and enter the URL to the LimeSurvey administration. Assuming you used 'limesurvey' as the directory name to store the files in, this will be something like "http://www.example.com/limesurvey/admin".
You should get a login screen. The default login credentials (if they have not been changed during the installation) are:
User: admin Password: password
You will be prompted to change the default password after you logged in. Have fun!
LimeSurvey uses the Yii file cache by default, but it can be configured to use other cache engines. Possible other caches are:
Please see the Yii documentation for full description.
Since LimeSurvey 4.0.0 you also have the possibility to cache calculations in the ExpressionScript. This can provide a significant speed-up depending on survey complexity. To enable the emcache, add this in your config.php file (components array):
'emcache' => array('class' => 'CFileCache'),
As with the main Yii cache, other cache systems can be used.
What if I have problems...
Like all computer programs, most of the time things will work just like the instructions say, but sometimes they just won't. There are too many possible reasons for things not going according to plan to describe here. If you have trouble, first check out the Installation FAQ. If you don't find your answer there, please post your problem and any error messages in the LimeSurvey forums, open a support ticket, or join the IRC channel: