Self-host LimeSurvey with Levelrail

A mature, self-hosted online survey tool for building and analyzing anonymous surveys.

  • AuthorLimeSurvey
  • LicenceGPL-2.0-or-later
  • Memory512 MiB
  • Archarm64
  • Services3

How to self-host LimeSurvey

  1. Pull the images

    3 images are pulled on your server.

    Show images
    • adamzammit/limesurvey:latest
    • mariadb:11
    • redis:7-alpine
  2. Create the app

    3 services start in a single Compose app, with 3 named volume mounts for your data, on port 80.

  3. Fill in the secrets

    4 secrets are generated and stored encrypted, 10 settings are preset, you do not have to fill in anything.

  4. Open it

    Without a domain the app gets an sslip.io address; add --domain SERVICE=HOST to use your own.

LimeSurvey requirements

Memory
About 512 MiB
Architectures
amd64 image published, arm64 image published
Ports
80
Domain
Optional, an sslip.io address is used without one
Settings
none to fill in
License
GPL-2.0-or-later, copyleft license
  • Listed. It is in the catalog but not verified. Back up the data volume before changing an image tag.
  • Host ports. It publishes port 80 on the host, so open them in the VPS firewall only if you want that.
  • Review. Image is not pinned to a version tag, so a redeploy can pull different code (adamzammit/limesurvey:latest).

Install Levelrail first

On a server with Levelrail running, run the command above, or open the dashboard: Apps, New app, Browse templates, then LimeSurvey. New to Levelrail? Install it on a fresh VPS first.

docker pull ghcr.io/glincker/levelrail:latest

Then levelrail-cli login --device. See Getting started and the LimeSurvey docs page.

Deploy LimeSurvey your way

Every format below deploys the same pinned images. Pick the one that fits how you work.

Deploy LimeSurvey from the CLI

levelrail-cli templates deploy limesurvey --name my-limesurvey

Deploy LimeSurvey with the API

Create a token in the dashboard first. This one-click route deploys it as a trial app you can keep or remove.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://levelrail.example.com/api/v1/service-templates/limesurvey/deploy

LimeSurvey configuration

LimeSurvey services

ServiceImagePortsVolumes
limesurvey adamzammit/limesurvey:latest 80 limesurvey_upload_data -> /var/www/html/uploadlimesurvey_config_data -> /var/www/html/application/config
mariadb mariadb:11 none limesurvey_mariadb_data -> /var/lib/mysql
redis redis:7-alpine none none

LimeSurvey environment variables

VariableServiceValue
LIMESURVEY_ADMIN_EMAIL limesurvey Preset by the template
LIMESURVEY_ADMIN_NAME limesurvey Preset by the template
LIMESURVEY_ADMIN_PASSWORD limesurvey Generated at deploy
LIMESURVEY_ADMIN_USER limesurvey Preset by the template
LIMESURVEY_DB_HOST limesurvey Preset by the template
LIMESURVEY_DB_NAME limesurvey Preset by the template
LIMESURVEY_DB_PASSWORD limesurvey Generated at deploy
LIMESURVEY_DB_USER limesurvey Preset by the template
Show all 14 variables
  • LIMESURVEY_PHP_SESSION_SAVE_HANDLERlimesurveyPreset by the template
  • LIMESURVEY_PHP_SESSION_SAVE_PATHlimesurveyPreset by the template
  • MYSQL_DATABASEmariadbPreset by the template
  • MYSQL_PASSWORDmariadbGenerated at deploy
  • MYSQL_ROOT_PASSWORDmariadbGenerated at deploy
  • MYSQL_USERmariadbPreset by the template

Ports and volumes

Ports
80
Volumes
3 named mounts: limesurvey_upload_data -> /var/www/html/upload, limesurvey_config_data -> /var/www/html/application/config, limesurvey_mariadb_data -> /var/lib/mysql

LimeSurvey FAQ

How much memory does LimeSurvey need?

The catalog lists about 512 MiB of memory for LimeSurvey across its 3 services.

Does LimeSurvey run on arm64?

For LimeSurvey, an arm64 image is published; amd64 is image published.

What licence is LimeSurvey under?

LimeSurvey is licensed under GPL-2.0-or-later, which is copyleft, so changes you distribute must be shared under the same terms.

Does LimeSurvey need configuration before it starts?

No. The template fills in its own defaults and generates secrets at deploy time.

Which database does LimeSurvey bundle?

The template includes MySQL and Redis, running as its own service.

Which ports does LimeSurvey use?

LimeSurvey listens on port 80 inside the stack.

Where does LimeSurvey keep its data?

In named volumes: limesurvey_upload_data mounted at /var/www/html/upload, limesurvey_config_data mounted at /var/www/html/application/config and limesurvey_mariadb_data mounted at /var/lib/mysql.

Can I deploy LimeSurvey on Dokploy or Dokku?

The services and pinned images on this page can be run on any Docker host. The public Dokploy templates list has an entry with the id limesurvey for this app, so check that entry as well. Dokku deploys container images with its own commands, so the pinned image adamzammit/limesurvey:latest, mariadb:11, redis:7-alpine is what you deploy there.

levelrail-cli templates deploy limesurvey --name my-limesurvey