Download
Wähle dein System, lade den Build herunter und starte ihn. Erweiterte Installationen sind einen Klick entfernt, falls du sie brauchst.
Plattform wählen
Tippe auf dein System. Wir zeigen zuerst den empfohlenen Download.
Windows 10 / 11
Installer herunterladen, ausführen und MeshChatX über das Startmenü öffnen. Portable, wenn du ohne Installation willst.
nur 64-Bit
Linux
Für die meisten reicht das AppImage. Herunterladen, ausführbar machen und starten.
AppImage
Portable Version, kein Paketmanager nötig. Lade die passende Architektur herunter.
chmod +x MeshChatX-*.AppImage
./MeshChatX-*.AppImageWeitere Installationsoptionen
Debian (.deb)
Debian- und Ubuntu-Pakete für AMD64 und ARM64.
sudo apt install ./MeshChatX-*.deb
# fallback if apt cannot resolve dependencies:
sudo dpkg -i MeshChatX-*.deb
sudo apt -f installRPM (.rpm)
RPM-Paket für 64-Bit-x86-Systeme.
sudo dnf install ./MeshChatX-*.rpm
# or on openSUSE:
sudo zypper install ./MeshChatX-*.rpmAlpine Linux (.apk)
apk-tools-Paket für Alpine Linux auf x86_64. Das ist nicht das Android-APK.
sudo apk add --allow-untrusted ./ReticulumMeshChatX-*-linux-alpine-*.apkArch
Manuell bauen und installieren mit unserem PKGBUILD. Diese Methode löst Abhängigkeiten und integriert sich mit pacman.
git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatX/packaging/archmakepkg -siAus dem Quellcode
Wenn du MeshChatX lokal aus dem Quellcode starten willst:
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
Wenn dein Linux Flatpak nutzt, installiere MeshChatX mit einem Klick. Flatpak hält die App danach aktuell.
Weitere Installationsoptionen
Terminal-Befehle
Lieber Terminal? Diese Befehle entsprechen dem Installieren-Button oben.
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//testingSchon von einer älteren MeshChatX-Flatpak-Quelle installiert? Entferne sie zuerst mit: flatpak remote-delete meshchatx
Heruntergeladene Datei
Die .flatpak-Datei schon heruntergeladen? So installierst du sie:
flatpak install --user ./ReticulumMeshChatX-*.flatpak
flatpak run com.quad4.meshchatxContainer
Compose-Datei kopieren, wenn du täglich Docker oder Podman nutzt. Pull-Befehle stehen unter weiteren Optionen.
Compose
Eine docker-compose.yml für Compose-Installationen.
services:
meshchatx:
image: quad4io/meshchatx:latest
# or ghcr.io/quad4-software/meshchatx:latest
ports:
- "8000:8000"
volumes:
- meshchatx-data:/root/.reticulum
volumes:
meshchatx-data:Weitere Installationsoptionen
Ausführung mit Docker. · AMD64 / ARM64
Gleiches Image aus beiden Registries. In Compose mit MESHCHAT_IMAGE auf GHCR wechseln.
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:latestAusführung mit Podman. · AMD64 / ARM64
Gleiches Image aus beiden Registries. In Compose mit MESHCHAT_IMAGE auf GHCR wechseln.
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:latestUmbrel
Installiere MeshChatX auf deinem Umbrel-Home-Server über den Umbrel App Store.
Docker-Images werden mit Trivy.
Python
Mit pip von PyPI installieren. Das reicht für die meisten.
pypi.org/project/reticulum-meshchatx
pip install reticulum-meshchatxWeitere Installationsoptionen
pipx install reticulum-meshchatxpoetry add reticulum-meshchatxuv pip install reticulum-meshchatxStarte den meshchatx-Einstieg aus dem Paket ohne dauerhafte Installation (uv tool run).
uvx --from reticulum-meshchatx meshchatxDirekte Wheel-URL
Exakte Wheel-Datei für dieses Release von GitHub pinnen.
pip install https://cdn.quad4.io/testing/nightly-2026.09.22-8366881/reticulum_meshchatx-4.9.1-py3-none-any.whlpipx install https://cdn.quad4.io/testing/nightly-2026.09.22-8366881/reticulum_meshchatx-4.9.1-py3-none-any.whlpoetry add https://cdn.quad4.io/testing/nightly-2026.09.22-8366881/reticulum_meshchatx-4.9.1-py3-none-any.whluv pip install https://cdn.quad4.io/testing/nightly-2026.09.22-8366881/reticulum_meshchatx-4.9.1-py3-none-any.whlAndroid
Android-APK für die App oder Termux für einen headless Node.
Universelles APK
Termux
Installation unter Android mit Termux. Abhängigkeiten installieren, dann MeshChatX über PyPI. Headless mit meshchat --headless.
pkg upgrade
pkg install python
pkg install rust
pkg install binutils
pkg install build-essentialpip install reticulum-meshchatxmeshchat --headless