monica/docs/installation/providers/docker.md

Installing Monica on Docker

Monica can run with Docker images.

• Prerequisites
• Use Monica docker image
• Running the image with docker-compose

Prerequisites

You can use Docker and docker-compose to pull or build and run a Monica image, complete with a self-contained MySQL database. This has the nice properties that you don't have to install lots of software directly onto your system, and you can be up and running quickly with a known working environment.

For any help about how to install Docker, see their documentation.

Use Monica docker image

The standard monica image can be run with the latest release of Monica.

Run the container with the command below (don't change the username/password):

mysqlCid="$(docker run -d \
 -e MYSQL_RANDOM_ROOT_PASSWORD=true \
 -e MYSQL_DATABASE=monica \
 -e MYSQL_USER=homestead \
 -e MYSQL_PASSWORD=secret \
 "mysql:5.7")"
docker run -d \
 --link "$mysqlCid":mysql \
 -e DB_HOST=mysql \
 -p 8080:80 \
 monica

Wait for the migration db to complete, then go to http://localhost:8080.

Running the image with docker-compose

See some examples of docker-compose possibilities in the example section.