Deploy Redmine Challenge Administration App with Docker

Jack Wallen walks you thru the method of deploying the Redmine mission administration device with the assistance of Docker Compose.

Redmine is an open-source mission administration platform you’ll be able to set up in your native LAN or to a third-party cloud host. This tackle mission administration consists of a number of mission assist, versatile role-based entry management, versatile challenge monitoring, Gantt charts, calendars, information, paperwork and file administration, feeds and electronic mail notifications, per-project wikis, and per-project boards.

SEE: Hiring package: Challenge supervisor (TechRepublic Premium)

Redmine is free to make use of and could be put in manually or by way of Docker. Because the guide set up could be a bit cumbersome for some, the extra logical and moveable methodology is to deploy the platform by means of Docker. And that’s precisely what I wish to present you.

What you’ll must deploy Redmine with Docker Compose

So as to make this work, you’ll want an working system that helps Docker. I’ll be demonstrating with Ubuntu Server 22.04, however you’ll be able to work with any working system that helps the container runtime in query.

Along with your OS of selection on the prepared, let’s get to it.

The way to set up the newest model of Docker

On the off-chance your working system doesn’t already embody Docker, let’s set up it.

The very first thing we’ll do is add the official Docker GPG key with:
curl -fsSL https://obtain.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
Subsequent, add the Docker repository:
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://obtain.docker.com/linux/ubuntu $(lsb_release -cs) steady" | sudo tee /and many others/apt/sources.listing.d/docker.listing > /dev/null
Set up the mandatory dependencies with the command:
sudo apt-get set up apt-transport-https ca-certificates curl gnupg lsb-release -y
Replace apt:

sudo apt-get replace

Set up the newest model of the Docker engine with the command:

sudo apt-get set up docker-ce docker-ce-cli containerd.io -y

To complete issues up, be sure your consumer remains to be a member of the docker group with the command:

sudo usermod -aG docker $USER

Sign off and log again in for the adjustments to take impact.

It is best to now have each the docker and docker-compose instructions prepared to make use of.

The way to create the Dockerfile

Subsequent, we have to create a Dockerfile that may outline the model of Redmine we’ll be utilizing. We’re going to make use of the newest, which is 5.0.3. Create a brand new listing with the command:

mkdir ~/redmine

Grow to be that listing with:

cd ~/redmine

Create the Dockerfile with:

nano Dockerfile

In that file, paste the next:

FROM redmine:5.0.3

RUN apt-get replace

Save and shut the file.

The way to create the docker-compose.yml file

We’ll now create the docker-compose.yml file with the command:

nano docker-compose.yml

model: '3.3'

providers:

   postgres:

     picture: postgres:10

     volumes:

       - ./storage/postgresql-data:/var/lib/postgresql/knowledge

     setting:

       POSTGRES_PASSWORD: "PASSWORD"

       POSTGRES_DB: "redmine"

       PGDATA: "/var/lib/postgresql/knowledge"

     restart: at all times

   redmine:

     construct:

       context: .

     picture: redmine:customized

     ports:

       - 80:3000

     volumes:

       - ./storage/docker_redmine-plugins:/usr/src/redmine/plugins

       - ./storage/docker_redmine-themes:/usr/src/redmine/public/themes

       - ./storage/docker_redmine-data:/usr/src/redmine/information

     setting:

       REDMINE_DB_POSTGRES: "postgres"

       REDMINE_DB_USERNAME: "postgres"

       REDMINE_DB_PASSWORD: "PASSWORD"

       REDMINE_DB_DATABASE: "redmine"

       REDMINE_SECRET_KEY_BASE: "…"

     restart: at all times

Ensure that to alter PASSWORD to a robust and distinctive password.

Save and shut the file. The above docker-compose file configures every thing crucial and even units up volumes for persistent knowledge.

The way to deploy the container

We are able to now deploy the container with the command:

docker-compose up -d

The way to entry Redmine

After the photographs are pulled and the container deployed, give it a minute to settle, after which, level your net browser to http://SERVER, the place SERVER is the internet hosting server IP deal with.

Try to be offered with the Redmine login web page, the place you’ll use the credentials admin/admin. Upon profitable login, you’ll be prompted to instantly change the admin consumer password (Determine A).

Determine A

After resetting the admin password, you’ll then be offered with a window the place you’ll be able to customise your account settings (Determine B).

Determine B

After you care for that, click on Administration within the prime menu bar. Within the ensuing window (Determine C), be sure to undergo the entire administration duties, equivalent to creating customers/teams/roles, configuring the workflow, taking good care of common settings, and many others.

Determine C

And there you go. Redmine is up and working and prepared that will help you handle these tasks like a boss.