MeshCore Self-Hosted

Self-hosted Docker container for the MeshCore web application.

Automatically downloads the latest MeshCore web release on startup and checks for updates daily.

Quick Start

docker-compose up -d

Access at http://localhost:7171

Connection Methods

USB (No HTTPS required)

Plug your MeshCore companion radio into your Unraid server via USB and connect directly in Chrome/Edge over HTTP. This is the simplest setup and works without any additional configuration.

Bluetooth (HTTPS required)

Bluetooth requires a secure context (HTTPS) in the browser. You must put this container behind a reverse proxy with a valid SSL certificate. Options:

• Cloudflare Tunnel — Easiest. Create a tunnel pointing to localhost:7171 and you get HTTPS automatically with no port forwarding needed.
• Nginx Proxy Manager — GUI-based reverse proxy, available in Unraid Community Applications.
• Caddy — Minimal config, auto-handles Let's Encrypt certificates.

Browser Compatibility

• Chrome / Edge — Works out of the box.
• Brave — Web Bluetooth is disabled by default. Go to brave://flags/#enable-web-bluetooth, set to Enabled, and restart.
• Safari / Firefox — Not supported. Web Bluetooth is not available in these browsers.

Note: Your MeshCore companion radio must be flashed with BLE companion firmware to use Bluetooth. USB serial and BLE are separate firmware builds — you can only use one at a time.

Environment Variables

Auto-Updates

The container checks for a new MeshCore release every UPDATE_INTERVAL seconds. When a new version is found it downloads and replaces the web files in place — nginx serves the new version immediately without a restart.

To disable auto-updates, pin to a specific version using MESHCORE_VERSION.

Unraid

Set container port 80 to your desired host port (e.g. 7171).

Map /app/data to a persistent path (e.g. /mnt/user/appdata/meshcore-selfhosted) to cache downloads. On restart the container will use the cached version instantly and only download again when a new release is available. If no cache exists or the server is unreachable, it falls back gracefully.