Jack Wallen strolls you through the procedure of deploying the Redmine project management tool with the aid of Docker Compose.
Image: Andrey Popov?adobe Stock Redmine is an open-source job management platform you can set up on your regional LAN or to a third-party cloud host. This take on task management consists of numerous job support, versatile role-based gain access to control, versatile concern tracking, Gantt charts, calendars, news, documents and file management, feeds and email notifications, per-project wikis, and per-project forums.
SEE: Hiring kit: Task manager (TechRepublic Premium)
Redmine is complimentary to use and can be installed by hand or by means of Docker. Since the manual setup can be a bit cumbersome for some, the more sensible and portable approach is to release the platform by method of Docker. And that’s precisely what I wish to show you.
What you’ll need to release Redmine with Docker Compose
In order to make this work, you’ll need an operating system that supports Docker. I’ll be demonstrating with Ubuntu Server 22.04, but you can work with any operating system that supports the container runtime in concern.
With your OS of option at the ready, let’s get to it.
How to set up the current variation of Docker
On the off-chance your operating system does not currently consist of Docker, let’s install it.
The very first thing we’ll do is add the official Docker GPG secret with:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg|sudo gpg– dearmor -o/ usr/share/keyrings/ docker-archive-keyring. gpg
Next, add the Docker repository:
echo “deb [arch=amd64 signed-by=/ usr/share/keyrings/ docker-archive-keyring. gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable”|sudo tee/ etc/apt/sources. list.d/ docker.list >/ dev/null
Install the needed reliances with the command:
sudo apt-get set up apt-transport-https ca-certificates curl gnupg lsb-release -y
Update apt:
sudo apt-get update
Install the current version of the Docker engine with the command:
sudo apt-get install docker-ce docker-ce-cli containerd.io -y
To complete things up, ensure your user is still a member of the docker group with the command:
sudo usermod -aG docker $USER
Log out and log back in for the modifications to take effect.
You ought to now have both the docker and docker-compose commands all set to utilize.
How to create the Dockerfile
Next, we need to develop a Dockerfile that will define the version of Redmine we’ll be utilizing. We’re going to use the current, which is 5.0.3. Create a brand-new directory site with the command:
mkdir ~/ redmine
Change into that directory site with:
cd ~/ redmine
Develop the Dockerfile with:
nano Dockerfile
Because file, paste the following:
FROM redmine:5.0.3 RUN apt-get update
Save and close the file.
How to produce the docker-compose. yml file
We’ll now create the docker-compose. yml file with the command:
nano docker-compose. yml variation: ‘3.3’ services: postgres: image: postgres:10 volumes: -./ storage/postgresql-data:/ var/lib/postgresql/ data environment: POSTGRES_PASSWORD: “PASSWORD” POSTGRES_DB: “redmine” PGDATA: “/ var/lib/postgresql/ data” restart: always redmine: construct: context:. image: 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/ files environment: REDMINE_DB_POSTGRES: “postgres” REDMINE_DB_USERNAME: “postgres” REDMINE_DB_PASSWORD: “PASSWORD” REDMINE_DB_DATABASE: “redmine” REDMINE_SECRET_KEY_BASE: “…” reboot: always
Ensure to alter PASSWORD to a strong and special password.
Conserve and close the file. The above docker-compose file sets up whatever required and even establishes volumes for relentless data.
How to deploy the container
We can now release the container with the command:
docker-compose up -d
How to gain access to Redmine
After the images are pulled and the container deployed, provide it a minute to settle, and then, point your web browser to http://SERVER, where SERVER is the hosting server IP address.
You should be presented with the Redmine login page, where you’ll use the credentials admin/admin. Upon effective login, you’ll be triggered to right away alter the admin user password (Figure A).
Figure A
The Redmine admin password change trigger. After resetting the admin password, you will then be presented with a window where you can customize your account settings (Figure B).
Figure B
Personalizing a user account in Redmine. After you take care of that, click Administration in the top menu bar. In the resulting window (Figure C), make sure to go through all of the administration jobs, such as developing users/groups/roles, setting up the workflow, looking after general settings, and so on.
Figure C
The Redmine Admin panel is where you take care of the remaining settings.
And there you go. Redmine is up and running and ready to help you manage those tasks like a manager.
