Element Admin

Element Admin is a web-based administration panel for the Element Server Suite, available in both ESS Pro and in the free ESS Community edition.

🚀 Try it

You can try the latest Element Admin using the hosted version at https://admin-beta.element.dev/.

🚀 Getting started

This component is developed and maintained by Element. It gets shipped as part of the Element Server Suite (ESS) which provides the official means of deployment.

ESS is a Matrix distribution from Element with focus on quality and ease of use. It ships a full Matrix stack tailored to the respective use case.

There are three editions of ESS:

• ESS Community - the free Matrix distribution from Element tailored to small-/mid-scale, non-commercial community use cases
• ESS Pro - the commercial Matrix distribution from Element for professional use
• ESS TI-M - a special version of ESS Pro focused on the requirements of TI-Messenger Pro and ePA as specified by the German National Digital Health Agency Gematik

💬 Community room

Developers and users of Element Admin can chat in the #ess-community:element.io room on Matrix.

📝 Prerequisites and standalone installation

Element Admin is designed to work with the components that ship with ESS. It assumes the following, which is handled out of the box by ESS version 25.9.2 or later:

• A Synapse instance and its admin API accessible
• A Matrix Authentication Service instance with its admin API accessible
• An domain name with a valid SSL certificate (HTTPS) where to host Element Admin. It must be served from a secure context, as required by the next-generation auth Matrix APIs.

Under the hood, Element Admin is a single-page application React application which can be deployed in any static hosting service or container environment.

🐳 Using Docker

A pre-built Docker image is available on Element's container registry:

docker run -p 8080:8080 oci.element.io/element-admin:latest

It can be configured using the following environment variables:

Variable	Description
SERVER_NAME	The name of the Matrix server to use. If not set, the user will be prompted to enter a server name.

A local Docker image can be built from the source code using the following command:

docker build -t element-admin .

📦 Building from the source code

1. Clone the repository:

git clone https://github.com/element-hq/element-admin.git
cd element-admin

2. Install dependencies (requires Node.js 18+ and pnpm):

pnpm install

3. Build the application

pnpm build

The built application will be in the dist/ directory, ready to be deployed to any static hosting service.

🌍 Translations

Element Admin is available in multiple languages. Anyone can contribute to translations through Localazy.

🏗️ Contributing

We welcome contributions from the community! If you'd like to suggest changes or contribute to the project, please come and chat with us first in the #ess-community:element.io room on Matrix.

Development workflow

• Linting & Formatting: Run pnpm lint to check code style and pnpm fix to auto-fix issues
• Translation extraction: Run pnpm i18n:extract when adding new translatable strings

⚖️ Copyright & License

Copyright 2025 New Vector Ltd. Copyright 2025, 2026 Element Creations Ltd.

This software is dual-licensed by Element Creations Ltd. It can be used either:

(1) for free under the terms of the GNU Affero General Public License (as published by the Free Software Foundation, version 3 of the License); OR

(2) under the terms of a paid-for Element Commercial License agreement between you and Element (the terms of which may vary depending on what you and Element have agreed to).

Unless required by applicable law or agreed to in writing, software distributed under the Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.