Skip to main content
Version: 2.0.27

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.

Above the table, OpenAdmin warns about accounts that hit their plan limits: a red box lists accounts at 100% of a limit, since websites, email or databases on them can fail until the limit is raised, and an orange box lists accounts at 90% or more. Each name opens that user, and long lists are shortened to the first few accounts.

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, Plan, Password, Email, IP, Disable 2FA, Delete Passkeys, Generate backup, Delete and Transfer Two users selected with the bulk actions bar offering Suspend, Unsuspend, Plan, Password, Email, IP, Disable 2FA, Delete Passkeys, Generate backup, Delete and Transfer

ActionWhat it does
SuspendSuspends the selected users, their websites stop working until they are unsuspended.
UnsuspendUnsuspends the selected users.
PlanMoves the selected users to the hosting plan you pick, resellers only see their allowed plans.
PasswordSets the password you enter (at least 8 characters) for all selected users.
EmailSets the email address you enter for all selected users.
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.
Scan with ImunifyAVStarts an ImunifyAV malware scan of the selected users' files. Shown when ImunifyAV is installed, not to resellers.
TransferMoves the selected accounts to another server over SSH, two at a time, see Transfer to another server. Enter the remote server, port and SSH login, click Test connection, then Start transfer. Tick Live transfer to suspend each account here and forward DNS to the remote server when it's done. The password is only used for this transfer and isn't saved. Not shown to resellers.

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 Plan, ask for it in the bar before you confirm:

Plan step of the bulk actions bar with a dropdown of hosting plans for two selected users 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. The form is split into sections:

  • Account: the username, email address (tick Send welcome email to send the user their login details) and password. Click Generate for a strong password.
  • Package: pick the hosting plan. Each card shows the plan's CPU, memory, storage and inodes, open View all limits for the rest.
  • Server options: open Advanced to choose the webserver for the account (and optionally enable Varnish cache), the database type (MySQL or MariaDB), and assign a reseller as the account's owner (Enterprise license only, and only when creating the user as a Super Admin/Admin). Leave it closed to use the server defaults.

Click Create user to create the account.

Create user account form with the Account, Package and Server options sections Create user account form with the Account, Package and Server options sections

  • 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 tabs for Overview, Services, Storage, Volumes, Resource usage, Activity and Login log, and a menu with Edit, Permissions, Export, Suspend (replaced by a single Unsuspend action if the account is already suspended) and Delete.

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 history link Overview tab of a user with gauges for storage, inodes, CPU and memory usage and the View history link

Click View history or the Resource usage tab to see the user's past resource usage: Date, CPU %, CPU usage, Memory %, Memory usage, Tasks and Warning. Use the search box to filter the rows. View raw opens the raw usage log in a new tab, and Download saves it as a .jsonl file.

If the usage stats stopped being collected, the tab says so and shows when the newest data is from. Check that the cron service is running and the opencli docker-collect_stats schedule on Scheduled actions.

Resource usage tab of a user with the past CPU, memory and tasks, and the View raw and Download buttons Resource usage tab of a user with the past CPU, memory and tasks, and the View raw and Download buttons

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 podman system df command run as the user.

  • Volumes: the user's files, databases and other data. Click Local Volumes in the table or Volumes (user files) under the bar to open the Volumes tab.
  • Containers: changes the user's containers made on top of their images.
  • Images: only the images the user pulled themselves. The images every account gets from the server's shared image store belong to root and aren't counted in the user's disk usage.

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

Volumes​

Volumes tab lists the user's podman volumes, biggest first, with the total count and size at the top:

  • Volume: the volume name and its description, for example This volume holds the mysql/mariadb databases.
  • Purpose: what the volume is for: storage, database or configuration.
  • Used by: the containers that mount the volume, with a green dot when the container is running. Hover a container to see the path it's mounted at.
  • Created: when the volume was created.
  • Size: the disk space the volume uses.

Click a volume to see its mountpoint on the server, driver and scope, compose project, number of links, exact size in bytes, every container that mounts it (path inside the container and whether it's read-write or read-only), and all of its labels and options. Refresh reloads the list.

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.