Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/crramirez/limesurvey

LimeSurvey - the most popular Free Open Source Software survey tool on the web. This docker image easies LimeSurvey installation. It includes a MySQL database as well as a web server. This is the most downloaded limesurvey container, but I don't have time to maintain it anymore. I am looking for a new maintainer
https://github.com/crramirez/limesurvey

docker-compose docker-container hacktoberfest limesurvey maintainer-wanted

Last synced: 6 days ago
JSON representation

Host: GitHub
URL: https://github.com/crramirez/limesurvey
Owner: crramirez
License: gpl-3.0
Created: 2014-08-08T18:26:40.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2020-07-01T08:22:03.000Z (over 4 years ago)
Last Synced: 2024-03-20T10:31:23.478Z (8 months ago)
Topics: docker-compose, docker-container, hacktoberfest, limesurvey, maintainer-wanted
Language: Dockerfile
Homepage: https://hub.docker.com/r/crramirez/limesurvey/
Size: 666 MB
Stars: 57
Watchers: 5
Forks: 105
Open Issues: 14
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

LimeSurvey
==========

LimeSurvey - the most popular
Free Open Source Software survey tool on the web.

https://www.limesurvey.org/en/

This docker image easies limesurvey installation. It includes a MySQL database as well a web server.

[![Try in PWD](https://raw.githubusercontent.com/play-with-docker/stacks/master/assets/images/button.png)](https://labs.play-with-docker.com/?stack=https://raw.githubusercontent.com/crramirez/limesurvey/master/docker-compose.yml)

## Usage

To run limesurvey in 80 port just:

```bash
docker pull crramirez/limesurvey:latest
docker run -d --name limesurvey -p 80:80 crramirez/limesurvey:latest
```

The latest image was upgraded to limesurvey 3, to continue using limesurvey 2 use:

```bash
docker pull crramirez/limesurvey:2
docker run -d --name limesurvey -p 80:80 crramirez/limesurvey:2
```

1. Go to a browser and type http://localhost
2. Click Next until you reach the *Database configuration* screen
3. Then enter the following in the field:
- **Database type** *MySQL*
- **Database location** *localhost*
- **Database user** *root*
- **Database password**
- **Database name** *limesurvey* #Or whatever you like
- **Table prefix** *lime_* #Or whatever you like

You are ready to go.

### Environment variables

To run limesurvey in a different http location set the `HTTP_LOCATION` environment variable.

```bash
docker run -d --name limesurvey -p 80:80 -e HTTP_LOCATION="surveys" crramirez/limesurvey:latest
```

Limesurvey will then be available via http://localhost/surveys.

## Database in volumes

If you want to preserve data in the event of a container deletion, or version upgrade, you can assign the MySQL data into a named volume:

```bash
docker volume create --name mysql
docker run -d --name limesurvey -v mysql:/var/lib/mysql -p 80:80 crramirez/limesurvey:latest
```

If you delete the container simply run again the above command. The installation page will appear again. Don't worry just put the same parameters as before and limesurvey will recognize the database.

## Upload folder

If you want to preserve the uploaded files in the event of a container deletion, or version upgrade, you can assign the upload folder into a named volume:

```bash
docker volume create --name upload
docker run -d --name limesurvey -v upload:/app/upload -v mysql:/var/lib/mysql -p 80:80 crramirez/limesurvey:latest
```

If you delete the container simply run again the above command. The installation page will appear again. Don't worry just put the same parameters as before and limesurvey will recognize the database and the uploaded files including images.

## Using Docker Compose

You can use docker compose to automate the above command if you create a file called *docker-compose.yml* and put in there the following:

```yml
version: '2'
services:
limesurvey:
ports:
- "80:80"
volumes:
- mysql:/var/lib/mysql
- upload:/app/upload
image:
crramirez/limesurvey:latest
volumes:
mysql:
upload:
```

To run:

```bash
docker-compose up -d
```

The [GitHub repository](https://github.com/crramirez/limesurvey) includes this [*docker-compose.yml*](https://github.com/crramirez/limesurvey/blob/master/docker-compose.yml) file which you can use to setup a basic container structure. You can add a [*docker-compose.override.yml*](https://docs.docker.com/compose/extends/#multiple-compose-files) to edit the default configuration.

## Separated containers
### MySQL
The repository also contains a Docker Compose configuration which builds a separate MySQL-container named [*docker-compose.mysql.yml*](https://github.com/crramirez/limesurvey/blob/master/docker-compose.mysql.yml).

**Warning**: The *docker-compose.mysql.yml* contains default MySQL database credentials. It is highly recommended to change these in a production environment.

To run with a separate MySQL-container:

```bash
export COMPOSE_FILE=docker-compose.mysql.yml
docker-compose up -d
```

1. Go to a browser and type http://localhost
2. Click Next until you reach the *Database configuration* screen
3. Then enter the following in the field:
- **Database type** *MySQL*
- **Database location** *mysql*
- **Database user** *root*
- **Database password** *limesurvey*
- **Database name** *limesurvey* #Or whatever you like
- **Table prefix** *lime_* #Or whatever you like

### PostgreSQL
The repository also contains a Docker Compose configuration which builds a separate PostgreSQL-container named [*docker-compose.pgsql.yml*](https://github.com/crramirez/limesurvey/blob/master/docker-compose.pgsql.yml).

**Warning**: The *docker-compose.pgsql.yml* contains default PostgreSQL database credentials. It is highly recommended to change these in a production environment.

To run with a separate PostgreSQL-container:

```bash
export COMPOSE_FILE=docker-compose.pgsql.yml
docker-compose up -d
```

1. Go to a browser and type http://localhost
2. Click Next until you reach the *Database configuration* screen
3. Then enter the following in the field:
- **Database type** *PostgreSQL*
- **Database location** *pgsql*
- **Database user** *postgres*
- **Database password** *limesurvey*
- **Database name** *limesurvey* #Or whatever you like
- **Table prefix** *lime_* #Or whatever you like