Download

A portable build with no package manager required. Download the architecture you need.

chmod +x MeshChatX-*.AppImage
./MeshChatX-*.AppImage

Debian and Ubuntu packages for both AMD64 and ARM64.

sudo apt install ./MeshChatX-*.deb
# fallback if apt cannot resolve dependencies:
sudo dpkg -i MeshChatX-*.deb
sudo apt -f install

An RPM package for 64-bit x86 systems.

sudo dnf install ./MeshChatX-*.rpm
# or on openSUSE:
sudo zypper install ./MeshChatX-*.rpm

Single-file bundle for systems with Flatpak installed.

flatpak install ./MeshChatX-*.flatpak

Build and install manually using our PKGBUILD. This method handles dependencies and integrates with pacman.

1. Clone & Navigate

git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatX/packaging/arch

2. Build & Install

makepkg -si

If you want to run MeshChatX from the source code locally:

1. Clone Repository

git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatX

2. Build Frontend (Node.js/pnpm)

corepack enable
pnpm install
pnpm run build-frontend

3. Run Backend (Python 3.10+/Poetry)

pip install poetry
poetry install
poetry run meshchat --headless --host 127.0.0.1

Standard docker-compose.yml for easy deployment.

services:
    reticulum-meshchatx:
        container_name: reticulum-meshchatx
        image: ${MESHCHAT_IMAGE:-quad4io/meshchatx:latest}
        restart: unless-stopped
        security_opt:
            - no-new-privileges:true
        ports:
            - 127.0.0.1:8000:8000
        volumes:
            - meshchatx-config:/config

volumes:
    meshchatx-config:
        name: meshchatx-config

Run using Docker. AMD64 / ARM64

Pull Image

Same image from either registry. Use MESHCHAT_IMAGE in Compose to pick GHCR.

Docker Hub

GitHub Container Registry

docker 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:latest

Docker images are scanned using Trivy.

Run using Podman. AMD64 / ARM64

Pull Image

Same image from either registry. Use MESHCHAT_IMAGE in Compose to pick GHCR.

Docker Hub

GitHub Container Registry

podman 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:latest

Docker images are scanned using Trivy.