Every plan

Install User Admin on your own Redmine

Requirements, install, update and removal steps for User Admin on a self-hosted Redmine 6, as a standard Redmine plugin.

Documented for version 1.0.1 · Verified against 932d12e

On this page
What it is

Redmine offers two states: you are an administrator, or you cannot touch user accounts at all. That is a poor fit for a workspace where an office manager or a team lead does the joiner and leaver paperwork — granting them administration to approve one registration also grants them your settings, your projects, and the ability to make themselves permanent. This adds the missing middle: a standalone Users area that does the day-to-day work and nothing else.

On your own Redmine

Requirements

  • Redmine 6.0 or newer (Rails 7.2, Ruby 3.1 or newer)
  • PostgreSQL 14+, or MySQL 8.0+ / MariaDB 10.6+
  • No additional gems, and no tables of its own

Install

cd /path/to/redmine
cp -r redminepro_user_admin plugins/
# no migrations — this feature owns no tables
# restart Redmine

Standalone behaviour

The seat display simply does not appear — there is no plan to report. Everything else is identical, including the whole hard wall above. The User Admin module hides its own checkbox from project settings whether or not anything else is installed.

Update and remove

Copy the new directory over the old one and restart. To remove:

rm -rf plugins/redminepro_user_admin
# restart Redmine

Nothing is lost: every change it made was an ordinary change to a Redmine account.

Already on RedminePRO Cloud? It is installed and maintained for you: see the configuration guide.

Ask about licences for your own Redmine