This page is for folks who don't want to use the hosted Quepid at http://www.quepid.com/.
This page is a work in progress, and is meant for use with Quepid 6.1.0 release and newer. Feedback appreciated!
Docker Compose based Install
Quepid can be deployed as several Docker containers. You can therefore deploy it on any Linux distribution that supports Docker. The target host requires Docker and Docker Compose to be installed.
The following table lists the software versions that must be installed on the target host.
|Docker engine||version 17.06.0-ce+ or higher||For installation instructions, see docker engine doc|
|Docker Compose||version 1.18.0 or higher||For installation instructions, see docker compose doc|
Quepid requires that the following ports be open on the target host.
|80||HTTP||Quepid app and core API accept HTTP requests on this port. You can change this port in the
The installation procedure involves the following steps:
- Download the production
docker-compose.prod.ymltemplate file via
wget https://raw.githubusercontent.com/o19s/quepid/master/docker-compose.prod.yml -O docker-compose.yml
- Configure the docker-compose.yml file to customize the settings for your production environment.
docker-compose pullto download all images required.
docker-compose up -d redis mysqlto start the dependencies. Count to 10 to give them a chance to fire up!
docker-compose run --rm app bin/rake db:setupto setup an empty database with the schema.
docker-compose up -dto start Quepid app.
- Browse to your server, i.e http://yourserver/ and after around 30 seconds on the first request you will be taken to the login screen.
Managing Quepid Lifecycle
You can use
docker-compose to manage the lifecycle of Quepid. Some useful commands are listed below. You must run the commands in the same directory as
$ docker-compose stop Stopping quepid_prod_app ... done Stopping quepid_prod_db ... done Stopping quepid_prod_redis ... done
Restart Quepid after Stopping:
$ docker-compose start Starting mysql ... done Starting redis ... done Starting app ... done
To update Quepid, stop the existing Quepid instance and review the current
docker-compose.prod.yml file in Github compared to your local
docker-compose.yml. Then run some database migration tasks:
$ docker-compose down $ vim docker-compose.yml $ docker-compose run --rm app bin/rake db:migrate $ docker-compose up -d
Quepid using WSL and Docker on Windows 10
It is possible to run this setup, but it is important to shutdown docker properly before exiting WSl shell using:
$ docker-compose down
In case you forgot to shutdown properly, the Quepid DB has been deleted. To reinstall the DB run:
$ docker-compose run --rm app bin/rake db:setup $ docker-compose up -d
Stop Quepid AND remove Quepid's database files on the file system:
$ docker-compose down $ rm -r ./volumes/mysql_data
** Warning you will lose your data!!! **