Installation - LimeSurvey CE/zh-hant

Note: These installation instructions are for version 2.0 or later. Older instructions for 1.92 can be found here and update instructions can be found here.

General

The LimeSurvey project provides two ways to install LimeSurvey:

• On your webserver:
  In that 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. We have prepared for this a special package for LimeSurvey which includes the web server, the database and the LimeSurvey application and instructions how to install it.

1. 你確定 LimeSurvey 能夠在你的網站使用

確定伺服器符合以下全部要求:

The minimum set of requirements will also be checked during the installation process!

The minimum set of requirements:

• Minimum 180 MB disk space
• MySQL 5.5.3 or later OR Microsoft SQL Server 2005 or later OR Postgres 9 or later
• Minimum PHP 5.3.3 or later, however we recommend PHP 5.5.x or later with the following modules/libraries enabled:
  • mbstring (Multibyte String Functions) extension library (see also Installation FAQ)
  • 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 (like hash, session, etc.).

Note: LimeSurvey 2.x uses different database drivers than 1.x . If you get a message not No DBO driver was found during the installation, you will have to contact your webspace provider and ask them to activate one of the aforementioned database driver libraries.

Note: If you are connecting from Linux to a MSSQL database on a Windows server using the dblib PDO driver, then the underlying FreeTDS needs to be set up correctly. Check out the Troubleshooting page for more info.

Optional PHP Extensions:

• GD-Library with FreeType support installed is needed for captchas or nice charts in statistics - 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 tokens using LDAP - see PHP LDAP Documentation
• Zip (pretty standard) for template upload and import resources Zip archives - see PHP Zip Extension documentation
• Zlib (pretty standard) is needed for the ComfortUpdate - see PHP Zlib Extension documentation

In most cases, your webspace provider or system administrator will be able to help you out on these optional components.

If you want to run Microsoft's IIS server, taking a look at "Installation on XP with IIS might also help.

Browser compatibility

For the survey-taking side, we currently support IE9 and all newer comparable browsers like FF, Chrome, Opera, etc. with activated JavaScript. For the administration part, we currently support IE11 and all newer comparable browsers like FF, Chrome, Opera, etc. with activated JavaScript. We do not support any IE version running in Intranet-mode or Compatibility-mode!

Screen sizes

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.

2. 下載 LimeSurvey 套件

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.

3. 解壓 LimeSurvey 軟件包

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 may include the space character.

4. 收集網站伺服器信息

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 (ie: 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.

5. LimeSurvey 的組態設定

使用自己的文字編輯器修改 /limesurvey/目錄內的 config.php 文件檔，下列設定要加以調整:

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.

  If you are using Linux, then setting permissions depends on your webserver configuration. For example, if you use Apache HTTPD on CentOS, type chmod -R 755 <directory> ; chown -R apache <directory>. This will give everyone access to read, and your webserver will have the permission to write. Check the following link for more information on Linux permissions.

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 to create 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.

Go to "http://www.example.com/limesurvey/admin". If you configured everything correctly, the LimeSurvey installer should be starting - just follow the instructions. You will be asked if to create the database and/or create the tables inside the database. LimeSurvey will then create the needed tables in the database.

8. 首次連結 admin 源程序

After the installer has finished you are done! 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 not changed during the installation) are:

User: admin
Password: password

緊記第一次登入後馬上要更改預設的密碼.

9. 我遇到問題怎麼辦...

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:

Direct link to the official LimeSurvey IRC Channel