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.

MeshChatX logo

Self-host MeshChatX

v4.10.7

Reticulum mesh client for messaging, calls, and browsing

ReleaseOpen SourceOther
Updatedlast week
LanguagePython
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
163
Port
8000 (HTTP/HTTPS web UI and API)
Requires
Python
Docker
ghcr.io/quad4-software/meshchatx
Install with Docker
Desktop conversation view in dark modeDesktop messages list in dark modeDesktop network visualiser showing mesh topologyDesktop contacts view in dark modeDesktop interfaces management in dark modeDesktop settings page in dark modeMobile conversation view in dark modeMobile messages list in dark modeMobile voice call screen in dark modeMobile settings page in dark mode

What is MeshChatX?

MeshChatX is a full-featured client for the Reticulum Network Stack, forked from the original MeshChat. It runs a local Python service with a Vue 3 web interface that you can host on a server, desktop, or mobile device. The app provides end-to-end encrypted direct messaging via LXMF, voice calls via LXST, a NomadNet page browser, RRC relay chat hubs, an offline-capable OpenLayers map, network visualization, file transfers, bot support, and a Micron editor. Multiple cryptographic identities can be created and switched, each with separate SQLite databases and settings. Authentication options include optional password auth and OIDC single sign-on with several providers. The UI features a dark theme and responsive design for mobile browsers, plus a native Android APK. Installation methods include Docker (standard, hardened, and extra images with I2P/Yggdrasil), PyPI wheels (pip/pipx/uv), Flatpak, AppImage, deb/rpm packages, Electron desktop builds, and Android APKs. The project is licensed under 0BSD for new code with upstream portions remaining MIT. Development ends January 1, 2027, with v5.0.0 as the final release.

Should you self-host MeshChatX?

MeshChatX scores 46/100 on selfhost.directory (how scoring works) and ranks #64 of 110 in Chat. It has 163 GitHub stars.

It shipped 4 stable releases in the past year. The latest, v4.10.7, came out on 11 October 2026.

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

Its closest alternative on selfhost.directory is Zulip (82/100, 26 133 stars). It scores higher overall, so compare the two before you pick. See MeshChatX vs Zulip side by side.

Features

  • Android app
  • Auto Backups & Snapshots
  • Bot support
  • File Transfer
  • LXMF Messaging
  • LXST Voice Calls
  • Multiple Identities
  • NomadNet Browser
  • Offline Map
  • OIDC Single Sign-On
  • OS Sandboxing
  • Password Authentication
  • RRC Relay Chat

MeshChatX README

How to install MeshChatX

Install MeshChatX with Docker

Docker Engine

docker compose -f docker/docker-compose.yml up -d

docker run -d --name reticulum-meshchatx
-p 127.0.0.1:8000:8000
-v meshchatx-config:/config
ghcr.io/quad4-software/meshchatx:latest

Standard, hardened, and extra (I2P/Yggdrasil) images available

How to configure MeshChatX

  • MESHCHAT_APPCONTAINERoffWindows AppContainer sandbox: 1 forces on, 0 forces off, auto enables with fallback

    Windows AppContainer sandbox: 1 forces on, 0 forces off, auto enables with fallback

    values: 1/0/auto/off

  • MESHCHAT_AUTHfalseRequire password authentication for the UI

    Require password authentication for the UI

    values: true/false

  • MESHCHAT_DATA_DIRnonePortable root for storage and .reticulum subdirs

    Portable root for storage and .reticulum subdirs

  • MESHCHAT_HEADLESSfalseDo not open a browser on startup

    Do not open a browser on startup

    values: true/false

  • MESHCHAT_HOST127.0.0.1Bind address for the web server

    Bind address for the web server

  • MESHCHAT_LANDLOCKautoLinux filesystem sandbox: 1/0 to force on or off

    Linux filesystem sandbox: 1/0 to force on or off

    values: 1/0/auto

  • MESHCHAT_NO_HTTPSfalseServe plain HTTP instead of HTTPS

    Serve plain HTTP instead of HTTPS

    values: true/false

  • MESHCHAT_OIDC_CLIENT_IDnoneOIDC client ID

    OIDC client ID

  • MESHCHAT_OIDC_CLIENT_SECRETnoneOIDC client secret

    OIDC client secret

  • MESHCHAT_OIDC_ENABLEDnoneForce OIDC single sign-on on or off

    Force OIDC single sign-on on or off

    values: true/false

  • MESHCHAT_OIDC_ISSUERnoneOIDC issuer URL

    OIDC issuer URL

  • MESHCHAT_PORT8000HTTP or HTTPS port

    HTTP or HTTPS port

  • MESHCHAT_RETICULUM_CONFIG_DIR~/.reticulumReticulum configuration directory

    Reticulum configuration directory

  • MESHCHAT_SECCOMPautoLinux seccomp syscall filter: 1/0 to force on or off

    Linux seccomp syscall filter: 1/0 to force on or off

    values: 1/0/auto

  • MESHCHAT_STORAGE_DIR./storageApplication data directory

    Application data directory

  • MESHCHAT_TRUSTED_PROXIESnoneProxy IPs/CIDRs allowed to supply X-Forwarded-* headers

    Proxy IPs/CIDRs allowed to supply X-Forwarded-* headers

MeshChatX releases & version history

More in P2P

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…