selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Element logo

Self-host Element

v1.12.35

Encrypted Matrix chat client for browsers and desktop

ReleaseOpen SourceAGPL-3.0
docker run --rm -p 127.0.0.1:80:80 vectorim/element-web
Updated3 days ago
LanguageTypescript
Setup difficultyModerate
ThemeDark mode
Stars
13 660
Port
80 (HTTP traffic served by nginx inside the Docker container (changeable via ELEMENT_WEB_PORT))
Requires
Matrix homeserver
Docker
vectorim/element-web
Element screenshot 1Element screenshot 2Element screenshot 3

What is Element?

Element Web is the open-source browser client for the Matrix network (previously known as Riot and Vector), built on the Matrix JS SDK and used for end-to-end-encrypted messaging, 1:1 and group voice/video calls, Spaces and device verification. It is a static web app: you serve it from your own web server using a release tarball, the element-web Debian package, the vectorim/element-web Docker image (port 80, customisable via ELEMENT_WEB_PORT, config.json bind-mounted at /app/config.json), or a Kubernetes example, and it connects to any Matrix homeserver you point it at through config.json. HTTPS is required for secure use and for WebRTC calls, and the docs recommend hosting it on a domain separate from your homeserver to limit XSS risk. Feature set is steered by a large config file covering default homeserver, SSO/OIDC redirect behaviour, themes and branding, Jitsi/Element Call conferencing, identity servers, integration managers, analytics and bug reporting, plus optional runtime modules and Labs flags. An Electron desktop app is downloadable from element.io, and native Element X apps are recommended for Android and iOS. Releases are published on GitHub roughly every two weeks under a multi-license: AGPL-3.0, GPL-3.0, or a paid Element commercial license.

Element alternatives

All self-hosted alternatives to Microsoft Teams →

Should you self-host Element?

Element scores 75/100 on selfhost.directory (how scoring works) and ranks #2 of 13 in Instant Messaging. It has 13 660 GitHub stars, +101 in the last 30 days.

It shipped 20 stable releases in the past year. The latest, v1.12.35, came out on 12 November 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Rocket.Chat (83/100, 46 522 stars). It scores higher overall, so compare the two before you pick. See Element vs Rocket.Chat side by side.

Features

  • Bridges, bots and widgets
  • Customizable themes and branding
  • Desktop App
  • Device verification
  • End-to-end encryption
  • Guest Access
  • Labs feature flags
  • Location Sharing
  • Matrix federation
  • Multi-language translations
  • Runtime extension modules
  • Spaces
  • URL previews
  • Voice and video calls

Element README

Chat Tests Static Analysis Localazy Quality Gate Status Coverage Vulnerabilities Bugs

Element

Element (formerly known as Vector and Riot) is a Matrix web & desktop client built using the Matrix JS SDK.

Supported Environments

Element has several tiers of support for different environments:

How to install Element

Install Element with Docker

Environment variables
ELEMENT_WEB_PORT
docker run --rm -p 127.0.0.1:80:80 vectorim/element-web

Custom config.json can be bind-mounted to /app/config.json; the listen port is changeable via ELEMENT_WEB_PORT.

How to configure Element

  • default_server_configCopy/pasted /.well-known/matrix/client object setting the default homeserver (and optional identity server) connection info.
  • default_server_nameConnect to the homeserver by looking up connection info via .well-known using the server's domain name.
  • disable_custom_urlsPrevents users from choosing their own homeserver and removes the server picker.

    values: true | false

  • default_themelightColour theme used by default; can also be a custom theme name.

    values: light | dark | custom theme name

  • brandElementOptional app name used throughout the application strings.

Element releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Instant Messaging

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…