Initial Setup with Docker

Docker Build

---

The MLSB app can be ran locally using Docker. One just needs to install Docker and run the setup.sh script. For those on Windows it is recommended to use git bash.

./setup.sh

This will create a Docker container with a postgres database, redis mem cache and flask web app. The following environment variables are defaulted but can be overridden simply by setting them in your environment:

1. ADMIN=admin (the admin's user name)
2. PASSWORD=password (the admin password)
3. DATABASE_URL=postgresql://$ADMIN:$PASSWORD@postgres:5432/mlsb (the postgres database to connect to)
4. KIK=kik (the Kik user name used to access certain APIs)
5. KIKPW=password (the password for the Kik user)
6. SECRET_KEY=secret (a secret key used by Flask)
7. REDIS_URL=redis://redis:6379/1 (the redis database to use for caching)

Finally, the app can be shutdown by simply running the teardown.sh script

./teardown.sh

Issues

Issue 1. Docker has an error when starting redis or postgres.

Solution 1. Just Restart docker docker stop $(docker ps -a -q)and hit restart on GUI.

Issue 2 Docker is unable to init DB

Solution 2 Run the ./teardown.sh script and re-run ./setup.sh