- Copy the zip file
- Unzip the file
- Delete the zip file
- Install the needed gems
- Migration
- Restart Redmine
- Video demonstration
This guide will teach you in detail how to install the Agile plugin on Redmine 7 that runs on Ubuntu Linux 26.04.
Copy the zip file
We have already downloaded the Agile in our Downloads folder.
In the Downloads folder:
Checked in the Linux terminal with the "ls" command:
As being the Downloads folder in your terminal, please use the below command to copy the file in your redmine/plugins folder.
sudo cp redmine_agile-1_6_14-pro.zip /var/www/html/redmine/plugins/
Note: Please keep in mind that the in the current example the Redmine is installed in the /var/www/html/redmine directory but it is up to you where it is installed, so the path to your Redmine in your case could be different. Also, the version of the plugin could be different as well in relation to the zip file name.
In terminal:
After it is copied the situation would be like this. Please navigate to your redmine/plugins directory.
- in the files directory:
- in the terminal with the "ls" command:
Unzip the file
As being in your redmine/plugins directory, please execute the below command to unzip the file.
sudo unzip redmine_agile-1_6_14-pro.zip
The result of the unzipping in your terminal would be these rows:
The result will be unzipped folder of the plugin.
- In terminal:
- In files directory:
Delete the zip file
The zip file is no longed needed, so we just delete it with the following command.
sudo rm -rf redmine_agile-1_6_14-pro.zip
Install the needed gems
Now you have to return back to the previous directory .../redmine/.
Important: Both gems and migration commands (the next command) have to be executed in the .../redmine/ directory and not the .../redmine/plugins directory.
Then run:
sudo bundle install
As a result will have the needed gems installed.
Migration
Please do the migration via this command:
sudo bundle exec rake redmine:plugins name=NAME_OF_THE_PLUGIN RAILS_ENV=production
The migration afterward will have these rows in your terminal:
Restart Redmine
We are almost done. The last step is to restart your Redmine.
In our case we run the Redmine in the terminal so I just close the terminal with the running terminal and open new one then execute the command to start Redmine (in the .../redmine/plugins directory):
sudo bundle exec rails server -e production
In the terminal it looks like this when started again:
Note: Please keep in mind that your Redmine could run in another way (not started via terminal) and you could restart it just like executing this command in the ...redmine/ directory ---> touch tmp/restart.txt.
When you refresh your Redmine in the browser page (as it has been restarted) you will see the new Agile installed successfully.
Video demonstration
To make the situation even more clear, please see this video demonstration of installation the Agile on Redmine 7.