Download

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

No AppImage assets in latest release.

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

Debian and Ubuntu packages for both AMD64 and ARM64.

No Debian packages in latest release.

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.

No RPM package in latest release.

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

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

1. Clone & Navigate

git clone https://git.quad4.io/RNS-Things/MeshChatX
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://git.quad4.io/RNS-Things/MeshChatX
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:-git.quad4.io/rns-things/meshchatx:latest}
        restart: unless-stopped
        security_opt:
            - no-new-privileges:true
        ports:
            - 127.0.0.1:8000:8000
        volumes:
            - ./meshchat-config:/config

Run using Docker. AMD64 / ARM64

Pull Image

docker run -d \
  --name reticulum-meshchatx \
  --restart unless-stopped \
  --security-opt no-new-privileges:true \
  -p 127.0.0.1:8000:8000 \
  -v ./meshchat-config:/config \
  git.quad4.io/rns-things/meshchatx:latest

Docker images are scanned using Trivy.

Run using Podman. AMD64 / ARM64

Pull Image

podman run -d \
  --name reticulum-meshchatx \
  --restart unless-stopped \
  --security-opt no-new-privileges:true \
  -p 127.0.0.1:8000:8000 \
  -v ./meshchat-config:/config \
  git.quad4.io/rns-things/meshchatx:latest

Docker images are scanned using Trivy.