A) Docker compose
The most seamless updating method in Redmine history thanks to briliant solution from Docker. Practically just replacing containers of the old verison with the new one using a single command.
How it works:
- Once you started your Easy Redmine via Docker, you have everything ready for installing updates. If you are running the VM with Docker inside, these configurations have been preset for you.
- Credentials to container registry
- APP_IMAGE variable in ENV configured to [registry-of-your-images]:latest
- Log in to the registry
docker login [registry-of-your-images] - Pull the image
docker compose pull
All details are provided in this dedicated article + information package you receive in the Client zone, including a comprehensive documentation for the image arthitecture.
If you find any issues with the provided documentation, do not hesitate to share them with us. We are committed to improving these resources based on feedback from administrators' practice.
B) Manual (legacy) update
In contrast to the Docker solution, the manual update requires some preparation and more focus on the procedure. If you have the option, please seriously consider Docker solution. If you are not allowed to install Docker directly in your infrastructure, we provide the option of VM which has Docker inside - giving you even more control over the processes.
The steps:
- Back up your current application, database and attachments.
- Download the zip package from Client zone.
- Read the release notes for the version you will be installing and update your technological stack accordingly.
- Back up config/database.yml, config/configuration.yml, /files. If you have repositories mirrored, also back them up.
- Delete everyting else
- Unpack the contents from the new zip package into Easy Redmine root
- Run commands one at a time
- bundle update
(Server requires internet access) - bundle exec rake db:migrate RAILS_ENV=production
- bundle exec rake easyproject:install RAILS_ENV=production
- Restart server
Needless to say, this procedure is much more sensitive to human or technical errors. The exact reason we invested so heavily in Docker - to outsource all of the tricky steps on our side and provide you with a plug-and-play scenario.
