Download
Pick your system, download MeshChatX, and open it. Extra install paths sit under More install options.
Choose your platform
Tap the system you use. The recommended download is first.
Windows 10 / 11
Download the installer, run it, and open MeshChatX from the Start menu. Use portable if you prefer no install.
64-bit only
Linux
Most people want the AppImage. Download it, make it runnable, and open it.
AppImage
Works on most Linux desktops without a package install. Pick your CPU type.
chmod +x MeshChatX-*.AppImage
./MeshChatX-*.AppImageMore install options
Debian (.deb)
For Debian and Ubuntu. Pick AMD64 or ARM64.
sudo apt install ./MeshChatX-*.deb
# fallback if apt cannot resolve dependencies:
sudo dpkg -i MeshChatX-*.deb
sudo apt -f installRPM (.rpm)
For Fedora, RHEL, and similar 64-bit x86 systems.
sudo dnf install ./MeshChatX-*.rpm
# or on openSUSE:
sudo zypper install ./MeshChatX-*.rpmAlpine Linux (.apk)
For Alpine Linux on x86_64. This is not the Android APK.
sudo apk add --allow-untrusted ./ReticulumMeshChatX-*-linux-alpine-*.apkArch
Build and install with our PKGBUILD. This pulls dependencies through pacman.
git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatX/packaging/archmakepkg -siFrom source
Run MeshChatX from a local copy of the source:
git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatXcorepack enable
pnpm install
pnpm run build-frontendpip install poetry
poetry install
poetry run meshchat --headless --host 127.0.0.1Flatpak
If your Linux uses Flatpak, install MeshChatX with one click. Flatpak keeps it updated after that.
More install options
Terminal commands
Prefer the terminal? These match the Install button above.
flatpak install --from https://cdn.quad4.io/flatpak/meshchatx-testing.flatpakref
flatpak run com.quad4.meshchatx
flatpak updateflatpak remote-add --if-not-exists meshchatx \
https://cdn.quad4.io/flatpak/meshchatx.flatpakrepo
flatpak install meshchatx com.quad4.meshchatx//testingInstalled from an older MeshChatX Flatpak source? Remove it first with: flatpak remote-delete meshchatx
Downloaded file
Already downloaded the .flatpak file? Install it with:
flatpak install --user ./ReticulumMeshChatX-*.flatpak
flatpak run com.quad4.meshchatxContainers
Already use Docker or Podman? Copy the Compose file below and start MeshChatX that way.
Compose
Standard docker-compose.yml for Compose-based installs.
services:
meshchatx:
image: quad4io/meshchatx:latest
# or ghcr.io/quad4-software/meshchatx:latest
ports:
- "8000:8000"
volumes:
- meshchatx-data:/root/.reticulum
volumes:
meshchatx-data:More install options
Run with Docker. · AMD64 / ARM64
Same image from either registry. Set MESHCHAT_IMAGE in Compose to use GHCR.
docker pull quad4io/meshchatx:latestdocker pull ghcr.io/quad4-software/meshchatx:latestdocker run -d --name reticulum-meshchatx \
--restart unless-stopped \
--security-opt no-new-privileges:true \
-p 127.0.0.1:8000:8000 \
-v meshchatx-config:/config \
quad4io/meshchatx:latestRun with Podman. · AMD64 / ARM64
Same image from either registry. Set MESHCHAT_IMAGE in Compose to use GHCR.
podman pull quad4io/meshchatx:latestpodman pull ghcr.io/quad4-software/meshchatx:latestpodman run -d --name reticulum-meshchatx \
--restart unless-stopped \
--security-opt no-new-privileges:true \
-p 127.0.0.1:8000:8000 \
-v meshchatx-config:/config \
quad4io/meshchatx:latestDocker images are scanned with Trivy.
Python
Install from PyPI with pip. That is enough for most people.
pypi.org/project/reticulum-meshchatx
pip install reticulum-meshchatxMore install options
pipx install reticulum-meshchatxpoetry add reticulum-meshchatxuv pip install reticulum-meshchatxRun MeshChatX once without a permanent install.
uvx --from reticulum-meshchatx meshchatxDirect wheel download
Grab the exact wheel file for this release.
pip install https://cdn.quad4.io/testing/nightly-2026.09.10-98cd7e6/reticulum_meshchatx-4.9.0-py3-none-any.whlpipx install https://cdn.quad4.io/testing/nightly-2026.09.10-98cd7e6/reticulum_meshchatx-4.9.0-py3-none-any.whlpoetry add https://cdn.quad4.io/testing/nightly-2026.09.10-98cd7e6/reticulum_meshchatx-4.9.0-py3-none-any.whluv pip install https://cdn.quad4.io/testing/nightly-2026.09.10-98cd7e6/reticulum_meshchatx-4.9.0-py3-none-any.whlAndroid
APK when it ships. Until then, Termux can run a headless MeshChatX node.
Universal APK
Termux
Install on Android with Termux. Install the packages, then MeshChatX from PyPI. Run headless with meshchat --headless.
pkg upgrade
pkg install python
pkg install rust
pkg install binutils
pkg install build-essentialpip install reticulum-meshchatxmeshchat --headless