Download
Scegli il sistema, scarica la build e avviala. Le installazioni avanzate sono a un clic, se ti servono.
Scegli la piattaforma
Tocca il sistema che usi. Mostriamo prima il download consigliato.
Windows 10 / 11
Scarica l’installer, eseguilo e apri MeshChatX dal menu Start. Usa portable se preferisci senza installazione.
solo 64 bit
Linux
Per la maggior parte basta l’AppImage. Scaricalo, rendilo eseguibile e avvialo.
AppImage
Build portatile, senza gestore pacchetti. Scarica l'architettura corretta.
chmod +x MeshChatX-*.AppImage
./MeshChatX-*.AppImageAltre opzioni di installazione
Debian (.deb)
Pacchetti Debian e Ubuntu per AMD64 e ARM64.
sudo apt install ./MeshChatX-*.deb
# fallback if apt cannot resolve dependencies:
sudo dpkg -i MeshChatX-*.deb
sudo apt -f installRPM (.rpm)
Pacchetto RPM per sistemi x86 a 64 bit.
sudo dnf install ./MeshChatX-*.rpm
# or on openSUSE:
sudo zypper install ./MeshChatX-*.rpmAlpine Linux (.apk)
Pacchetto apk-tools per Alpine Linux su x86_64. Non è l'APK Android.
sudo apk add --allow-untrusted ./ReticulumMeshChatX-*-linux-alpine-*.apkArch
Compila e installa manualmente con il nostro PKGBUILD. Gestisce le dipendenze e si integra con pacman.
git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatX/packaging/archmakepkg -siDal sorgente
Se vuoi eseguire MeshChatX in locale dal codice sorgente:
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
Se il tuo Linux usa Flatpak, installa MeshChatX con un clic. Flatpak lo terrà aggiornato dopo.
Altre opzioni di installazione
Comandi da terminale
Preferisci il terminale? Questi comandi corrispondono al pulsante Installa sopra.
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//testingGià installato da una vecchia sorgente Flatpak MeshChatX? Rimuovila prima con: flatpak remote-delete meshchatx
File scaricato
Hai già scaricato il file .flatpak? Installalo così:
flatpak install --user ./ReticulumMeshChatX-*.flatpak
flatpak run com.quad4.meshchatxContainer
Copia il file Compose se usi Docker o Podman ogni giorno. I comandi pull sono sotto altre opzioni.
Compose
Standard docker-compose.yml per installazioni basate su Compose.
services:
meshchatx:
image: quad4io/meshchatx:latest
# or ghcr.io/quad4-software/meshchatx:latest
ports:
- "8000:8000"
volumes:
- meshchatx-data:/root/.reticulum
volumes:
meshchatx-data:Altre opzioni di installazione
Esecuzione con Docker. · AMD64 / ARM64
Stessa immagine da entrambi i registry. In Compose usa MESHCHAT_IMAGE per 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:latestEsecuzione con Podman. · AMD64 / ARM64
Stessa immagine da entrambi i registry. In Compose usa MESHCHAT_IMAGE per 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:latestLe immagini Docker sono analizzate con Trivy.
Python
Installa da PyPI con pip. Per la maggior parte delle persone basta così.
pypi.org/project/reticulum-meshchatx
pip install reticulum-meshchatxAltre opzioni di installazione
pipx install reticulum-meshchatxpoetry add reticulum-meshchatxuv pip install reticulum-meshchatxEsegui il punto d'ingresso meshchatx dal pacchetto senza installazione permanente (uv tool run).
uvx --from reticulum-meshchatx meshchatxURL wheel diretto
Aggancia il file wheel esatto per questa release da GitHub.
pip install https://cdn.quad4.io/testing/nightly-2026.09.21-23dc68c/reticulum_meshchatx-4.9.1-py3-none-any.whlpipx install https://cdn.quad4.io/testing/nightly-2026.09.21-23dc68c/reticulum_meshchatx-4.9.1-py3-none-any.whlpoetry add https://cdn.quad4.io/testing/nightly-2026.09.21-23dc68c/reticulum_meshchatx-4.9.1-py3-none-any.whluv pip install https://cdn.quad4.io/testing/nightly-2026.09.21-23dc68c/reticulum_meshchatx-4.9.1-py3-none-any.whlAndroid
APK Android per l’app, oppure Termux per un nodo headless.
APK universale
Termux
Installazione su Android con Termux. Installa le dipendenze, poi MeshChatX da PyPI. Esecuzione headless con meshchat --headless.
pkg upgrade
pkg install python
pkg install rust
pkg install binutils
pkg install build-essentialpip install reticulum-meshchatxmeshchat --headless