Skip to content
This plugin adds role-based access controls (RBAC) to YOURLS.
Branch: master
Clone or download
Latest commit fec171d Jan 5, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
authmgr Remove API permission for anon user Jun 1, 2013
LICENSE Release under license GPLv3 Jun 18, 2013 refer to AuthMgrPlus Jan 5, 2019


Please see AuthMGrPlus for active development. AuthMgrPlus is a substantial update and rewrite to this plugin which realizes most-if-not-all requested/desired feature and clears all error-based issues.

This plugin adds role-based access controls (RBAC) to YOURLS. By assigning users to roles like "Editor" and "Contributor" you can limit the changes they are permitted to make.

With access controls enabled, you can safely delegate access to the admin pages.


  1. Download the latest release of yourls-authmgr-plugin.
  2. Copy the plugin folder into your user/plugins folder for YOURLS.
  3. Set up the parameters for authmgr (details below)
  4. Activate the plugin with the plugin manager in the YOURLS admin interface.

Default Roles

The default roles are set up as follows:

Role Capabilities
Administrator No Limits
Editor Cannot manage plugins
Contributor Cannot manage plugins, edit URLs, or delete URLs


Add role assignments to your user/config.php file.

$authmgr_role_assignment = array(
  'administrator' => array(
  'editor' => array(
  'contributor' => array(

You can also designate a range of IP addresses that will automatically be granted all capabilities. By default, all accesses from IPv4 localhost ( are granted full access.

$authmgr_admin_ipranges = array(


Copyright 2013 Nicholas Waller (

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 3 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, see

You can’t perform that action at this time.