Installing Contacts plugin on Docker Container Redmine 7 in Linux

• Download plugin
• Unzip
• Copying Contacts to the Redmine plugins' folder
• Gems installation and Database migration
• Precompile
• Docker Container restart
• Video demonstration

The following guide will teach you in detail how to install the Contacts plugin on Docker Container Redmine 7.0.1 stable version via operating system Linux Ubuntu 26.04 LTS.

Note: If you haven't installed your Redmine Docker Container yet, please follow the steps of this guide.

We have already started our Docker Container via the command:

sudo docker compose up -d

Download plugin

Firstly, you need to download the very latest version of the Contacts. In my specific case I have already done this in my Downloads folder.

• In the files system of Ubuntu Downloads folder

• In the Ubuntu terminal

Unzip

As being in the Downloads folder, please unzip the file via this command:

unzip redmine_agile-1_7_0-pro.zip

Note: Please keep in mind that the version of the plugin could be different in the moment you check this guide in relation to the zip file name. For example, it could be higher version.

If you see the below rows then everything is fine with the unzipping process.

Then you will have unzipped folder of the plugin.

• In terminal

• In Ubuntu file system

Copying Contacts to the Redmine plugins' folder

Every command from now on will include the name of your Docker Redmine Container. So it is very important to know its name. It can be checked via the command:

sudo docker ps

In our current case the name of the container is dimitar_container.

Note: Please keep in mind that no matter which path you entered in your Linux terminal (still staying in Downloads in the current example), there will be no problem, because the next commands are going to be executed inside the Docker Container itself.

Before you copy the Contacts plugin, you can list the existing plugins in your list via the command:

sudo docker exec -it dimitar_container ls -l plugins/

Now please copy the file from your files system of Ubuntu to the Redmine Docker container:

sudo docker cp ./redmine_contacts dimitar_container:/usr/src/redmine/plugins

If you list the plugins again (with the previous command), you will see the successfully copied Contacts.

Gems installation and Database migration

This command is very important. It contains 4 commands in it. In the same way as other commands it all happens inside the Docker Redmine Container itself and its inner command line.

sudo docker exec -it dimitar_container bash -c " 
  cd /usr/src/redmine && \
  bundle config set --local without 'development test' && \
  bundle install && \
  bundle exec rake redmine:plugins NAME=redmine_contacts RAILS_ENV=production
" 

Let's see what every single command is doing:

• cd /usr/src/redmine - changes the directory of execution in the core Redmine folder
• bundle config set --local without 'development test' - excludes any set of gem installation for development and test modes of Redmine (as we need for production only)
• bundle install - installs all the required gems that are specifically needed for the Contacts plugin

• bundle exec rake redmine:plugins NAME=redmine_contacts RAILS_ENV=production - Database migration

Precompile

Just putting the assets statically in Redmine 7 and Rails 8.1 is not enough to be processed fully. That's why we need to explicitly execute them via the precompile command.

sudo docker exec -it dimitar_container bash -c " 
  cd /usr/src/redmine && \
  bundle exec rake assets:precompile RAILS_ENV=production
" 

Docker Container restart

The very last thing that we need to do is just restart your Docker Container.

sudo docker restart dimitar_container

Now please just refresh your Redmine web page in the browser. As a result you have up and running Redmine 7 Docker Container with Contacts plugin successfully installed and running as well.

Video demonstration

Please check the below video demonstration of installation the Contacts on Docker Container Redmine 7 to see the process and steps in action.