Recommended
Docker
Runs on Linux, macOS, Windows, servers, and Raspberry Pi. The dashboard is available at http://<host>:8110.
Save that one file into a new folder, open a terminal in that folder, and run:
docker compose up -d
That is the whole install. Docker downloads MeshWX Pro App for you and starts it,
picking the right build for your machine automatically. Then open
http://<host>:8110.
There is nothing else to download. If you have used an older
release that needed a .tar.gz image file, you do not need one any more.
Windows
Windows installer
Download and run the MeshWX Pro App installer. It installs the application on your PC and creates a desktop icon you can use to launch MeshWX Pro App.
Upgrading
Moving to a newer release.
Open a terminal in the same folder as your docker-compose.yml and run
these two commands:
docker compose pull
docker compose up -d
Your settings, history and transmit log are kept. They live in the data
folder next to the compose file and are never touched by an upgrade.
To confirm it worked, open the dashboard and check the version shown at the bottom of
the left sidebar.
Do not replace your docker-compose.yml when you
upgrade, and do not download it again. It contains no version number, so the same
file keeps working for every future release.
Raspberry Pi
Headless Raspberry Pi
Everything here runs over SSH, so there is nothing to download in a browser.
If the Pi does not have Docker yet, install it first:
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker
Then make a folder, pull the compose file straight onto the Pi, and start it:
mkdir meshwx && cd meshwx
curl -O https://meshwxpro.com/docker/docker-compose.yml
docker compose up -d
Open http://<pi-ip>:8110 from another device on your network.
The compose file uses restart: unless-stopped, so MeshWX Pro App
comes back on its own after a reboot or a crash.
To upgrade later, run docker compose pull then
docker compose up -d in that same meshwx folder.
Use a 64-bit Raspberry Pi OS. A 32-bit OS cannot run the image.
Coverage
Regional alert support
MeshWX Pro App supports official alert coverage for:
- United States
- Canada
- European Union
- Israel
- Australia
After installation
Finish setup in the dashboard.
- Open
http://<host>:8110.
- In Settings → Region, choose the United States, Canada, European Union, Israel, or Australia and select your area.
- In Settings → Radios, choose Meshtastic and/or MeshCore, connect the radio, and select the alert channel.
- Use Troubleshoot → Send test to confirm the radio transmits, then turn Broadcasting on.