Allows OpenProject users to upload a picture to be used as an avatar or use registered images from Gravatar.
Clone or download
Latest commit 45c9143 Oct 2, 2018

OpenProject Avatars Plugin

This plugin allows users to add an avatar picture to their user profile. They can either

  • Use a Gravatar image assigned to their registered mail address
  • Upload a local avatar

As an admin, you can enable or disable each of these features.


The OpenProject Avatars plugin requires the OpenProject Core to be in the same version as the plugin.


To install the OpenProject Avatars plugin you need to add the following line to the Gemfile.plugins in your OpenProject folder (if you use a different OpenProject version than OpenProject 7, adapt :branch => "stable/7" to your OpenProject version):

gem "openproject-avatars", git: "", :branch => "stable/7"

Afterwards, run:

bundle install


Remove the line

gem "openproject-avatars", git: "", :branch => "stable/7"

from the file Gemfile.plugins and run:

bundle install

Bug Reporting

If you find any bugs, you can create a bug ticket at


To contribute, you can create pull request on the official repository at


A. Chaika wrote the original version of the local-avatars plugin

Luca Pireddu at CRS4 (, contributed updates and improvements.


  • Copyright (C) 2011-2017 OpenProject GmbH


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.