> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openhands.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Super Admin Dashboard

> Manage every organization, user, and instance-wide setting on an OpenHands Enterprise installation.

Use the Super Admin dashboard to manage all organizations and users on your OpenHands Enterprise installation from
one place. A Super Admin is an instance-wide administrator. This role is separate from the organization
[roles](https://docs.openhands.dev/openhands/usage/cloud/organizations/roles-permissions.md) Owner, Admin, and Member.

## Open the Dashboard

Choose `Super Admin` from your user menu, or `Super Admin Dashboard` from the organization selector. Only Super
Admins see these entries.

The first user to sign in to a new installation is a Super Admin. When an existing installation is upgraded and has
no Super Admin, the user who signed in first becomes one. To make more people Super Admins, see
[Manage Super Admins](#manage-super-admins).

## First-Install Setup

On a new installation, the first Super Admin goes through a setup wizard after signing in:

1. Add your license key or offline license file. You can skip this step and add the license later.
2. Enter your company name and logo.
3. Name your first organization. You become its owner.

After the wizard, add an LLM for the organization, then continue with the setup guide.

The wizard and setup guide appear only for that first user. An installation that already has users when it is
upgraded does not show the wizard to anyone.

### Setup Guide

The setup guide tracks the remaining steps to get the first organization running agents:

1. Add an LLM.
2. Connect Git.
3. Create an automation.
4. Add an integration (an MCP server).
5. Invite users.

Open the guide from `Setup guide` in the Super Admin navigation or from the lower-right corner of the app. Each step
is marked done when OpenHands detects it. To hide the guide, remove it from the navigation. To show it again, turn on
`Show Setup guide` in [Instance Settings](#instance-settings).

## Review Usage

Use the `Dashboard` page to review usage across organizations. It has `Overview`, `Users`, `Models`, and
`Conversations` tabs.

* Choose `All organizations`, or compare selected organizations.
* Choose a time window: 7 days, 30 days, 90 days, or year to date.
* On the `Conversations` tab, search and filter conversations, export them as CSV, or stop a running conversation.

## Manage Organizations

The `Organizations` page lists every organization with its member count, contact email, and status.

* **Create an organization**: Click `Create organization`. Enter a name, contact name, and contact email, and choose
  the owner. You are the owner unless you choose another user.
* **Open an organization**: Click its name, or choose `View organization` from the row menu. The Super Admin role
  does not make you a member. To open an organization you don't belong to, grant yourself access and choose a role.
* **Invite people**: Choose `Invite by email` from the row menu, enter email addresses, and choose a role. This
  option requires email delivery, such as [SMTP](https://docs.openhands.dev/enterprise/vm-install/admin-console-configuration.md#smtp-email-delivery).
* **Remove an organization**: Choose `Remove` from the row menu. You can't undo this. OpenHands refuses to remove an
  organization when a member has no other organization.

Personal workspaces belong to their users. You can't open, invite people to, or remove another user's personal
workspace. For settings that control personal workspaces and a default organization, see
[Configuring Organizations](https://docs.openhands.dev/openhands/usage/cloud/organizations/configuring-organizations.md).

## Manage Users

The `Users` page lists every user with their organizations, roles, and status. Pending invitations appear in the
list too.

Click a user, or choose `Manage user` from the row menu, to change their access:

* **Organization access**: Add the user to an organization with a role, change their role, or suspend, resume, or
  remove their membership in the organizations you select.
* **Suspend account**: Block the user from signing in and using API keys in every organization. Click
  `Activate account` to restore access.
* **Delete user**: Remove the user's account, API keys, and conversations in every organization. You can't undo this.

OpenHands refuses to remove, demote, or delete the last owner of an organization, and to suspend or delete the last
Super Admin. You can't suspend or delete your own account.

## Manage Super Admins

Super Admins can create organizations, invite users, and manage other Super Admins.

* **Grant**: On the `Users` page, choose `Grant Super Admin` from the user's row menu and confirm.
* **Revoke**: On the `Super Admins` page, choose `Revoke` from the row menu and confirm. You can't revoke your own
  access. Ask another Super Admin to do it.

## Instance Settings

Use the `Instance Settings` page for settings that apply to every organization:

* **Company logo**: Replaces the OpenHands logo in the top left.
* **Company name**: Appears at the top of the Settings navigation.
* **Allow users to have personal workspace**: Shows whether personal workspaces are on. Change it in your deployment
  configuration. See [Configuring Organizations](https://docs.openhands.dev/openhands/usage/cloud/organizations/configuring-organizations.md).
* **Show Setup guide**: Shows or hides the [setup guide](#setup-guide). Only the first Super Admin can change it.
* **Enable Service Accounts (beta)**: Lets organizations run automations under a service account instead of a
  personal account.

## License

Use the `License` page to enter a license key or upload an offline license file. Get either one from Customer
Center. A license set in your installation's configuration takes precedence and can't be changed on this page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.