---
title: How to manage Hyperglance users (Legacy Docker Guide)
description: Hyperglance holds its own internal database of users and we have shell scripts that you can use to manage users. By default Hyperglance comes loaded with a single admin user whose username is 'admin'
---

[Skip to content](https://support.hyperglance.com/knowledge/managing-users-post-5.2-legacydocker#main-content)

English

Show submenu for translations

[More support](https://support.hyperglance.com/knowledge/kb-tickets/new?hsLang=en)

![](https://support.hyperglance.com/hs-fs/hubfs/hyperglance.png?width=100&height=75&name=hyperglance.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [More support](https://support.hyperglance.com/knowledge/kb-tickets/new)
- [Contact Us](https://www.hyperglance.com/contact/)

[Contact Us](https://www.hyperglance.com/contact/)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Hyperglance Support](https://support.hyperglance.com/knowledge?hsLang=en)
2. [Setup & Configuration](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en)
3. [Legacy Docker-based deployments](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#legacy-docker-based-deployments)

# How to manage Hyperglance users (Legacy Docker Guide)

THIS GUIDE IS DEPRECATED AND PERTAINS TO THE LEGACY DOCKER BASED ARCHITECTURE.  [SEE LATEST VERSION.](https://support.hyperglance.com/knowledge/managing-users?hsLang=en)

Hyperglance holds its own internal database of users and we have shell scripts that you can use to manage users.

By default Hyperglance comes loaded with a single admin user whose username is '**admin**' and the initial password would be the instance-id, computer name or just 'admin' depending on how you deployed Hyperglance (see your deployment documentation for details).

To get started quickly see the example scenarios at the bottom of this page!

### User Management Scripts

Our user management scripts are located in **/usr/local/bin/users**

#### adduser.sh

Adds a user to the database. The user is created with no roles and will not be able to login, so must be followed up with a call to **setroles.sh** to assign appropriate roles.

```
adduser.sh <username> [password]
```

- **username** - Required. A unique username to create.
- **password** - Optional. The password of the user. If not provided as a parameter argument then the script will interactively prompt to enter a password (and again to confirm).

#### deleteuser.sh

Removes a user from the database.

```
removeuser.sh <username>
```

- **username** - Required. The name of the user to remove.

#### listusers.sh

Prints out all users in the database.

```
listusers.sh
```

#### resetpassword.sh

Modifies the password of an existing user.

```
resetpassword.sh <username> [password]
```

- **username** - Required. The name of a user whose password will be changed.
- **password** - Optional. The password of the user. If not provided as a parameter argument then the script will interactively prompt to enter a password (and again to confirm).

#### setroles.sh

Assigns (or re-assigns) a set of roles to an existing user.

The script will automatically include the most basic "HyperglanceUser" role which is enough to grant read-only login ability to a user (although additional roles are needed to grant access to view topologies).

Learn more about how roles work in [Hyperglance's RBAC system](https://support.hyperglance.com/knowledge/role-based-access-control-rbac?hsLang=en).

```
setroles.sh <username> [roles]
```

- **username** - Required. The name of a user to grant roles to.
- **roles** - Optional. A comma-separated list of roles to assign to the user.

### Scenario Examples

#### Change the password of the default 'admin' user:

```
cd /usr/local/bin/users./resetpassword.sh admin
```

#### Add an additional admin user:

```
cd /usr/local/bin/users./adduser.sh kirk./setroles.sh kirk HyperglanceAdmin
```

#### Add a power user who can do everything except for administration duties:

```
cd /usr/local/bin/users./adduser.sh spock./setroles.sh spock HyperglanceContributor
```

#### Add a user who can view (read-only) your 'production1' account:

```
cd /usr/local/bin/users./adduser.sh uhura./setroles.sh uhura production1
```

#### Add a user who can view and trigger automations against (read/write) your 'dev2' account:

```
cd /usr/local/bin/users./adduser.sh scotty./setroles.sh scotty HyperglanceActionsUser,dev2
```

 

- [Before You Start](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#main-content)

    - [Kubernetes](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#kubernetes)
    - [GCP](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#gcp)
    - [AWS](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#aws)
    - [Azure](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#azure)
- [Using Hyperglance](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#main-content)

    - [Automations](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#automations)
    - [Inventory & Diagrams](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#inventory-diagrams)
    - [Rules](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#rules)
    - [Cost Management](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#cost-management)
    - [Dashboards](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#dashboards)
    - [Security & Compliance](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#security-compliance)
- [Setup & Configuration](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#main-content)

    - [Updating & Migrating](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#updating-migrating)
    - [General](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#general)
    - [RBAC & Users](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#rbac-users)
    - [STIGS & FIPS](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#stigs-fips)
    - [AWS](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#aws)
    - [Azure](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#azure)
    - [Kubernetes](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#kubernetes)
    - [GCP](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#gcp)
    - [API](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#api)
    - [Legacy Docker-based deployments](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#legacy-docker-based-deployments)
    - [AI](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#ai)

[![Chill listening crop-3](https://support.hyperglance.com/hs-fs/hubfs/hyperglance.png?width=134&height=24&name=hyperglance.png "Chill listening crop-3")](https://www.hyperglance.com/)

2880 Zanker Road, Suite 203, San Jose, CA 95134

<https://www.linkedin.com/company/hyperglance/>

Copyright © 2025 Hyperglance. All rights reserved.