Skip to content
Local Avatars for redmine - initially imported from
Branch: master
Clone or download
Pull request Compare This branch is 12 commits ahead of ncoders:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Fix avatar position if Gravatar is disabled Jun 29, 2019


This plugin allows Redmine users to upload a picture to be used as an avatar (instead of depending on images from Gravatar).

Users can set their image through the /my/account page. The administrator can also manage users' avatars through the /users section.


Place this plugin into the folder plugins/ of your redmine installation. Make sure that the folder is called "redmine_local_avatars".

Update the gems, run any migrations:

bundle install --without development test
rake redmine:plugins:migrate RAILS_ENV=production

And restart your application server.


This current version on github is compatible with Redmine 2.1 - 3.3.

It has been imported from lp:redminelocalavatars incorporating the patch for 2.1 from chrisy at


As reported in issue #12, the plugin "mega_calendar" ist not compatible with this plugin due to an issue with the provided users_controller_path.rb file.

Old version on launchpad

Tested on Redmine trunk r4388 (version 1.0.3). Should be compatible with all Redmine versions 1.0.x.

At the moment the plugin doesn't work when running in development mode.


Luca Pireddu at CRS4 (, contributed updates and improvements.

Warranty. What warranty?

This plugin was written for use in an intranet with simple requirements in mind. In particular, not much attention has been payed to security issues and there hasn't been any thorough testing. Use it at your own risk.
Patches are welcome.

Implementation Notes

Avatar images are treated as attachments to User objects with the description 'avatar'. The AccountController is patched to provide the images, and the UsersController and MyController are patched to provide mechanisms to add/delete avatars.


Copyright (C) 2010 Andrew Chaika, Luca Pireddu
Copyright (C) 2015 dup2

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

You can’t perform that action at this time.