Skip to main content
Version: 2.0.14

Users

OpenPanel has a single user role named User that can only manage their docker container and inherits settings specified by the Admin user.

List Users​

To access all OpenPanel users, navigate to Accounts > Users.

The Users page displays a table with user information and buttons to manage it.

Users page listing OpenPanel accounts with their status, plan, memory, CPU, disk and inodes usage and the Impersonate button Users page listing OpenPanel accounts with their status, plan, memory, CPU, disk and inodes usage and the Impersonate button

The Memory, CPU, Disk and Inodes columns show the user's current usage as a percentage of their plan limit. Hover over a ring to see the exact usage and limit, click the Memory or CPU ring to open the user's processes, or the Disk ring to open their Storage tab. A ? means there is no disk usage data for that user yet.

The Created column shows how long ago the account was created, like 5d ago or 3mo ago. Hover over it to see the exact date and time.

Use the filters above the table to narrow down the list:

  • Status – show active users, suspended users, or both.
  • Package – show only users on the selected hosting plan. The list includes every plan that has at least one user.
  • Owner (Enterprise license only, not shown to resellers) – show only users owned by the selected reseller, or users with no reseller.

Users page with the Package filter open, listing All packages and each hosting plan in use Users page with the Package filter open, listing All packages and each hosting plan in use

Filters work together with the search box, and Showing X of Y below the table counts the users that match. The selected Package and Owner are kept in the page address (for example /users?plan=Standard+plan), so a filtered list can be bookmarked or shared. The user count on the Hosting Plans page links to the Users page with that plan already selected.

Click the arrows next to a column name to sort the table by that column. Sorting works for Username, Email, 2FA, Passkeys, Package, Domains, Memory, CPU, Disk, Inodes, Context, Created and Owner. The usage columns sort by the percentage shown in the ring.

Additional columns can be displayed using the 'Show Columns' button.

Show Columns menu of the Users table with a toggle for each column, including 2FA and Passkeys Show Columns menu of the Users table with a toggle for each column, including 2FA and Passkeys

  • 2FA – whether the user has two-factor authentication enabled.
  • Passkeys – how many passkeys the user has registered, empty if they have none.

Suspended users are highlighted in red.

Bulk Actions​

Tick the checkbox of one or more users, or the checkbox in the table header to select all users shown by the current search. A bar appears at the bottom of the page with the number selected, a Clear link and these actions:

Two users selected with the bulk actions bar offering Suspend, Unsuspend, Change plan, Change password, Change email, Change IP, Disable 2FA, Delete Passkeys, Generate backup and Delete Two users selected with the bulk actions bar offering Suspend, Unsuspend, Change plan, Change password, Change email, Change IP, Disable 2FA, Delete Passkeys, Generate backup and Delete

ActionWhat it does
SuspendSuspends the selected users, their websites stop working until they are unsuspended.
UnsuspendUnsuspends the selected users.
Change planMoves the selected users to the hosting plan you pick, resellers only see their allowed plans.
Change passwordSets the password you enter (at least 8 characters) for all selected users.
Change emailSets the email address you enter for all selected users.
Change IPMoves the selected users to a dedicated IP address of the server, or back to the shared IP.
Disable 2FATurns off two-factor authentication, users without 2FA are skipped.
Delete PasskeysDeletes all passkeys of the selected users, they have to register them again to log in with a passkey. Users without passkeys are skipped.
Generate backupStarts a full account backup for each selected user in the background, the same as Export > Generate full account backup.
DeletePermanently deletes the selected users with all their websites, databases, emails and files.

Only the action that fits a user runs on it: suspended users are skipped by Suspend and active ones by Unsuspend.

Actions that need a value, like Change plan, ask for it in the bar before you confirm:

Change plan step of the bulk actions bar with a dropdown of hosting plans for two selected users Change plan step of the bulk actions bar with a dropdown of hosting plans for two selected users

Click an action, confirm it, and it runs on the selected users one after another. When it's done the page reloads with a notice listing the users it worked for, or which ones failed and why.

Create Users​

To create a new user, click on the Create New button on the Users page. A form is displayed where you can set the username, email address (optionally sending the user a welcome email with their login credentials), and generate a strong password.

You can also choose the webserver for the account (and optionally enable Varnish Cache), the database type (MySQL or MariaDB), assign a reseller as the account's owner (Enterprise license only, and only when creating the user as a Super Admin/Admin), and select a hosting plan to assign to the user.

Create New user form with username, email, password, webserver, database type and hosting plan Create New user form with username, email, password, webserver, database type and hosting plan

  • The OpenPanel username must be 3 to 20 characters long and can only contain letters and numbers.
  • The OpenPanel password must be 6 to 30 characters long and cannot contain an apostrophe (').

Single User​

To view detailed information about a user, and edit their settings, click on their username in the users table. The user page has a menu on the left with these tabs: Overview, Services, Storage, Edit, Permissions, Export, Suspend (replaced by a single Unsuspend action if the account is already suspended), Delete, Activity Log and Login Log.

Statistics​

Overview is the default tab. Its top part displays current usage statistics:

  • Storage used
  • Inodes used
  • CPU usage
  • Memory usage
  • Number of running containers
  • Disk I/O
  • Network I/O
  • Number of PIDs
  • Time statistics usage was last update
  • Historical usage

Overview tab of a user with gauges for storage, inodes, CPU and memory usage and the View Past Usage button Overview tab of a user with gauges for storage, inodes, CPU and memory usage and the View Past Usage button

Clicking on 'View Past Usage' will display a table with past resource usage for the user: Date, CPU %, CPU usage, Memory %, Memory usage and Tasks.

Past resource usage table of a user with the date, CPU and memory usage and the number of tasks Past resource usage table of a user with the date, CPU and memory usage and the number of tasks

Services​

Services tab displays all user services (docker containers). Columns can be toggled with the 'Show Columns' button and include:

  • Service name
  • Docker Image name and tag
  • Published ports
  • Environment variables (sensitive values such as passwords are masked and can be revealed on click)
  • Current CPU usage
  • Current Memory usage
  • Actions, including a terminal link to run podman exec commands in that service.

An 'Edit Services' button also lets Administrators edit the raw service configuration.

Services tab listing the user containers with their CPU and memory usage, PIDs and actions Services tab listing the user containers with their CPU and memory usage, PIDs and actions

Bulk Actions​

Tick the checkbox of one or more services, or the checkbox in the table header to select all services shown by the current search. A bar appears at the bottom of the page with the number selected, a Clear link and these actions:

Two services of a user selected with the bulk actions bar offering Start, Stop, Restart, Edit CPU, Edit RAM and Edit PIDs Two services of a user selected with the bulk actions bar offering Start, Stop, Restart, Edit CPU, Edit RAM and Edit PIDs

ActionWhat it does
StartStarts the selected services.
StopStops the selected services.
RestartRestarts the selected services.
Edit CPUSets the CPU limit (cores) you enter, 0 means unlimited.
Edit RAMSets the memory limit in GB you enter, 0 means unlimited.
Edit PIDsSets the max number of processes you enter, 0 means unlimited.

Click an action, confirm it, and it runs on the selected services one after another. When it's done the page reloads with a notice listing the services it worked for, or which ones failed and why.

Storage​

Storage tab displays data from the docker system df command.

  • Volumes
  • Containers
  • Images

Storage tab with the user volumes, containers and images from docker system df Storage tab with the user volumes, containers and images from docker system df

Overview​

Below the usage statistics, the Overview tab displays detailed user information.

User details on the Overview tab: username, email, plan, locale, 2FA status, IP address, location, server, docker context and setup time User details on the Overview tab: username, email, plan, locale, 2FA status, IP address, location, server, docker context and setup time

Displayed information:

  • Username
  • Email Address
  • User ID
  • IP Address
  • Geo Location for the IP
  • Server Name
  • Docker Context
  • 2FA status
  • Reseller (if the user is owned by a reseller)
  • Setup Time

Permissions​

The Permissions tab lets Administrators view and, for individual users, override which OpenPanel features/pages are enabled. By default a user's permissions follow their hosting plan's defaults; switching to Custom mode allows enabling or disabling individual features for that user only, independent of the plan. Plan-wide feature defaults are managed separately in Feature Manager.

Permissions tab where the enabled OpenPanel features follow the plan or are set per user Permissions tab where the enabled OpenPanel features follow the plan or are set per user

Activity​

Displays users activity log.

  • Date
  • Action performed
  • IP Address

Activity Log tab with the date and the action performed Activity Log tab with the date and the action performed

Login Log​

Displays a log of successful logins for the user, separate from the general Activity log:

  • Date
  • Country
  • IP Address

Login Log tab with the date, country and IP address of each login Login Log tab with the date, country and IP address of each login

Edit​

From the Edit tab, Administrators can edit user information:

  • Username
  • Email address
  • Password (leave empty to keep the current password)
  • IP address
  • Reseller (change the account's owner/reseller)
  • Hosting Package

Click Save to apply the changes.

Edit tab with the username, email, password, IP address, reseller and hosting package fields Edit tab with the username, email, password, IP address, reseller and hosting package fields

Below the form, the Edit tab also lets Administrators set a custom message that is shown to this user in OpenPanel.

Export​

The Export tab has two options:

  • Generate full account backup – Creates a compressed archive of the account's home directory, databases, domains, websites, email, FTP, DNS zones, SSL certificates, cronjobs and containers/images. Previously generated backups are listed below, where they can be downloaded or deleted.

Export tab with the Generate full account backup option and the list of existing backups Export tab with the Generate full account backup option and the list of existing backups

  • Transfer to another server (Enterprise license only) – Migrates the user account, along with all its containers and data, to another OpenPanel server over SSH. You provide the remote server's address/port and root SSH credentials, and can optionally enable "Live Transfer" so that once the migration completes, the account is automatically suspended on the current server and its domains' DNS is updated to point to the new server.

Transfer to another server form on the Export tab with the remote server, SSH credentials and the Live Transfer option Transfer to another server form on the Export tab with the remote server, SSH credentials and the Live Transfer option

Suspend​

Suspending an account will immediately disable the user's access to the OpenPanel. This action involves pausing the user's Docker container and revoking access to their email, website, and other associated services. Please be aware of the immediate impact before proceeding.

To suspend a user, open the "Suspend" tab on that user's page and type the username to confirm, then click the Suspend account button.

Suspend tab asking to type the username before suspending the account Suspend tab asking to type the username before suspending the account

Unsuspend​

For a suspended user, the row of tabs on the user's page is replaced with a single Unsuspend button. Click it to restore access for the user.

Reset Password​

To reset password for a user, click on the "Edit" tab and set the new password in the Password field (leave it empty to keep the current password) then click Save.

Edit tab with the password field and the Generate button Edit tab with the password field and the Generate button

Rename​

To rename a user, click on the "Edit" tab for the user, then change the 'Username' field and click Save.

Change Package​

To change a package for a user, click on the "Edit" tab for the user, then select the new hosting plan and click Save.

Change Email​

To change email address for a user, click on the "Edit" tab for the user, then change the 'Email' field and click Save.

Login to OpenPanel​

To auto-login to a user's OpenPanel account, click on the Impersonate button in the top-right corner of the user's page.

Delete User​

To delete a user, open the "Delete" tab for that user, type the username to confirm, then click Delete account permanently.

Delete tab asking to type the username before deleting the account permanently Delete tab asking to type the username before deleting the account permanently

DANGER

This action is irreversible and will permanently delete all user data.