Installing the Plugin Manually

Oct 13, 2025 by wbrum.org 125 views

Introduction

When trying to install a plugin in the Bitnami Redmine docker image, the container exits with a debug message. The issue arises when the plugin requires additional gems, specifically the json gem, which fails to install due to a lack of development tools. In this article, we will explore the issue, its causes, and possible solutions.

The Problem

When trying to install the plugin using the Bitnami Redmine docker image (latest Redmine 6.0.4), the container exits with the following debug info:

redmine 15:06:34.68 INFO  ==> Executing database migrations
redmine 15:06:34.69 DEBUG ==> Generating secret tokens
bundler: failed to load command: rake (/opt/bitnami/redmine/vendor/bundle/ruby/3.3.0/bin/rake)
/opt/bitnami/ruby/lib/ruby/gems/3.3.0/gems/bundler-2.6.3/lib/bundler/definition.rb:454:in `ensure_equivalent_gemfile_and_lockfile': The dependencies in your gemfile changed, but the lockfile can't be updated because frozen mode is set (Bundler::ProductionError)

This error message indicates that the bundler gem is unable to load the rake command due to a change in the Gemfile dependencies. The error message also mentions that the json gem is required by the oauth2 gem, which is a dependency of the plugin.

The Cause

The cause of the issue is the lack of development tools in the Bitnami Redmine docker image. The json gem requires the json library to be installed, which is not present in the image. As a result, the json gem fails to install, and the bundler gem is unable to load the rake command.

The Solution

To resolve the issue, you need to install the development tools in the Bitnami Redmine docker image. You can do this by running the following command:

apt-get update && apt-get install -y build-essential

This command will install the necessary development tools, including the json library.

Installing the Plugin Manually

If you want to install the plugin manually, you can follow these steps:

Clone the plugin repository using git:

git clone https://github.com/kontron/redmine_oauth.git

Change into the plugin directory:

cd redmine_oauth

Run bundle install to install the required gems:

bundle install

Run rake to install the plugin:

rake

Conclusion

In conclusion, the issue of failing to install a plugin in the Bitnami Redmine docker image is caused by the lack of development tools in the image. To resolve the issue, you need to install the development tools using apt-get. Alternatively, you can install the plugin manually by cloning the repository, running bundle install, and then running rake.

Additional Tips

Make sure to update the Gemfile to include the required gems.
Run bundle install to install the required gems.
Run rake to install the plugin.
If you encounter any issues during the installation process, check the mkmf.log file for more details.

Troubleshooting

If you encounter any issues during the installation process, check the mkmf.log file for more details.
Make sure to update the Gemfile to include the required gems.
Run bundle install to install the required gems.
Run rake to install the plugin.

Related Issues

References

Introduction

In our previous article, we explored the issue of failing to install a plugin in the Bitnami Redmine docker image. In this article, we will provide a Q&A section to help you better understand the issue and its solutions.

Q: What is the cause of the issue?

A: The cause of the issue is the lack of development tools in the Bitnami Redmine docker image. The json gem requires the json library to be installed, which is not present in the image.

Q: How can I resolve the issue?

A: To resolve the issue, you need to install the development tools in the Bitnami Redmine docker image. You can do this by running the following command:

apt-get update && apt-get install -y build-essential

Q: What are the development tools required?

A: The development tools required are:

build-essential
json library

Q: How can I install the plugin manually?

A: To install the plugin manually, you can follow these steps:

Clone the plugin repository using git:

git clone https://github.com/kontron/redmine_oauth.git

Change into the plugin directory:

cd redmine_oauth

Run bundle install to install the required gems:

bundle install

Run rake to install the plugin:

rake

Q: What are the required gems for the plugin?

A: The required gems for the plugin are:

json
oauth2

Q: How can I update the Gemfile to include the required gems?

A: To update the Gemfile to include the required gems, you can add the following lines to the Gemfile:

gem 'json'
gem 'oauth2'

Q: What is the purpose of the `mkmf.log` file?

A: The mkmf.log file is used to log the compilation errors of the json gem. You can check this file to see why the json gem failed to compile.

Q: How can I troubleshoot the issue?

A: To troubleshoot the issue, you can check the mkmf.log file for more details. You can also try running bundle install with the --verbose flag to see more detailed output.

Q: What are some related issues?

A: Some related issues are:

Q: Where can I find more information?

A: You can find more information on the Bitnami Redmine docker image documentation, Redmine plugin development documentation, and Bundler documentation.

Q: What are some additional tips?

A: Some additional tips are:

Make sure to update the Gemfile to include the required gems.
Run bundle install to install the required gems.
Run rake to install the plugin.
If you encounter any issues during the installation process, check the mkmf.log file for more details.