Mayan EDMS Docker Installation

Quick setup guide to Mayan EDMS using docker-compose.

Once I decided to install Mayan EDMS to try it out, I started with the most straightforward installation using https://docs.mayan-edms.com/chapters/docker/install_docker_compose.html#docker-compose-install. If you want to use Mayan EDMS, and you aren’t doing development, it is the best way to get started.

I am running Ubuntu 18.04 LTS on a development machine I originally setup to learn about edX, and do edX application development.

If you haven’t already, install docker and docker-compose.

For Ubuntu install docker-ce, docker-ce-cli, and containerio.d packages. See the https://docs.docker.com/engine/install/ubuntu/ for more information on Ubuntu installation including setting up the docker Ubuntu repository.

sudo apt-get install docker-ce docker-ce-cli containerd.io

If you already have docker setup, make sure docker-compose is installed. Docker Compose is a tool for setting up multiple docker containers that work together. For example, you may run PostgreSQL in one container, and your application code would run in another. Learn more about https://docs.docker.com/compose/install/.

sudo curl -L "https://github.com/docker/compose/releases/download/1.25.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

Next get the Mayan EDMS docker compose file

curl https://gitlab.com/mayan-edms/mayan-edms/-/raw/master/docker/docker-compose.yml -O

Then you can customize the docker-compost.yml file directly, or create a .env file with your local settings.

Then you can just run

docker-compose --file docker-compose.yml --project-name mayan up --detach

This will download the relevant packages, and build the docker containers.

When the command completes Mayan EDMS should be running on localhost.The login page will show the initial randomly generated login info, so login and change the password before allowing network access to your new Mayan EDMS installation.

In the next post I’ll explain how I setup for Mayan EDMS development.