Developers Documentation



301 error for file:

User Tools

Site Tools


The user manager page allows you to add, delete and manage users on the ClearOS system.


If you install any app that depends on users/groups, this app will automatically be installed.

You can find this feature in the menu system at the following location:


Video Tutorial


User Overview

The first thing you will see on the user manager page is a summary of existing users. This summary includes the username and full name.

User Information

When adding or editing a user, you must configure the following fields:

  • Username
  • First name
  • Last name
  • Password

In addition, you can also:

  • Configure optional fields such as telephone number, address, title, and more.
  • Select the permitted applications for the user.
  • Specify group membership on the system.

A username must follow these conventions:

  • Must be all lower case (many 3rd party apps and services require this)
  • Can contain letters, numbers, and the following special characters: _ - . $


Your ClearOS password must follow these rules:

  • Must start with a letter or number
  • Must not contain the following characters: | ; *

App Policies

For all the packages you have installed and require permission to use, this is where you give them permission.

When adding a new user, the App Policies default to Enabled. Make sure you change them as required.

Unless you use the Active Directory Connector, you can also control the permissions from the Account Manager app and from the individual apps in their Plugins section


Here you will see the users e-mail address and you can add any alias here. The alias is added without the domain so “admin” and not “”. The domain is taken from the Mail Domain in Mail Settings app.

It is possible to forward mail to external e-mail addresses using a beta facility. From the command line issue the command:

touch /var/clearos/mail_routing/forwarders

At this point, you should be able to see a new “Forwarders” section. There is currently a risk of duplicate e-mails with this facility and it is known not to work with Kopano.


You can add users to any groups here

Windows Groups

You can add users to any Windows Networking group here.

content/en_us/7_ug_users.txt · Last modified: 2019/02/25 05:50 by nickh