This is a brief summary of the steps required to update this redmine installation.

The official upgrade documentation is found at

NOTE: The Redmine installation is a git clone from All modifications to existing and newly created configuration files are in the local branch edit-redmine-production. Thereby the update process does not involve moving/copying config files etc.

In the following it is assumed that the commands are executed from within the redmine installation folder, so as first step


1. Enable maintenance mode

Uncomment the following line in /etc/apache2/sites-available/siteconf/

# Disabling Redmine for maintenace
RewriteCond $1                  !^projects/edit/wiki/Maintenance.*
RewriteCond $1                  !^stylesheets/.*
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# restrict access by IP Adress:
#  ...
RewriteCond  %{REMOTE_ADDR}     !^**\.**\.**\.**$ 
RewriteRule ^/redmine/(.*) [R]

Reload Apache

service apache2 reload

2. Backup

mysqldump -h 160.45.63.*** -uredmine -p redmine | bzip2 > ../redmine-$(date +"%Y-%m-%d").sql.bz2
tar -czf ../redmine-$(date +"%Y-%m-%d").tar.gz ../redmine

3. Update the code base

git fetch -t
git fetch 
git tag --list

Check if the target release tag is available

Update by rebasing

(Create a new branch for each minor version)

git rebase --onto $TAG $LAST_TAG edit-redmine-production-3.3

4. Update the dependencies and database

bundle install --without development test rmagick
bundle exec rake generate_secret_token
bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
bundle exec rake tmp:cache:clear tmp:sessions:clear
service apache2 restart

Finally go to "Administration -> Roles & permissions" to check/set permissions
for new features, if any

5. Disable maintenance mode

Comment the line in the virtual host configuration again and reload apache.

Updated by Andreas Kohlbecker almost 4 years ago ยท 10 revisions