- Download plugin
- Unzip
- Copying Agile 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 Agile 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 Agile. 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 Agile 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 Agile 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 ./{{migration_plugin_name}} dimitar_container:/usr/src/redmine/plugins
If you list the plugins again (with the previous command), you will see the successfully copied Agile.
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_agile 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 Agile plugin
- bundle exec rake redmine:plugins NAME=redmine_agile 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
As a result you have up and running Redmine 7 Docker Container with Agile plugin successfully installed and running as well.
Video demonstration
Please check the below video demonstration of installation the Agile on Docker Container Redmine 7 to see the process and steps in action.