# users.conf

This file defines all users.

The format of the file is:

    username:password:"description"

Parameter Name | Description
--- | ---
username | The name of the user. The username cannot exceed 255 characters in length.
password | Leave this item blank when creating a new user. For example:
    bob::"Bob Smith"
There is one predefined user, the administrator. User passwords are not entered in this configuration file, and remain empty (and therefore not secure) until you set them using the administration tool; see Assigning a Password to the Administrator. You can also create users and assign passwords using API calls; see the API reference for the language you are working with.
description | A string describing the user.

## Example

    admin::"Administrator"
    Bob::"Bob Smith"
    Bill::"Bill Jones"

After the server has started and passwords have been assigned, the file will look like this:

    admin:$1$urmKVgq78:"Administrator"
    Bob:$2$sldfkj;lsafd:"Bob Smith"
    Bill:$3$tyavmwq92:"Bill Jones"

Copyright © Cloud Software Group, Inc. All rights reserved.