Installing ITSWEBER Mesh on Unraid

Unraid is one of the primary targets for ITSWEBER Mesh — if you are running Unraid 6.10+, installation is a three-click process.

Prerequisites

• Unraid 6.10 or higher
• Plugin Community Applications installed (present on 99 % of all Unraid servers; if not: the Apps tab appears after installing the plugin in Settings)
• A free port — default 3000

Installation in 3 clicks

1. Open the Apps tab in the Unraid WebUI

2. Search for "itsweber mesh" → click "Install" on the container card

3. In the Edit Container form fill in only MESH_SESSION_SECRET — everything else has sensible defaults:

   • WebUI Port: 3000 (adjust if occupied)
   • Config Volume: /mnt/user/appdata/itsweber-mesh
   • MESH_SESSION_SECRET: 32+ characters, generated via openssl rand -hex 32 (on the Unraid console)
   • TZ: Europe/Berlin

4. Click Apply — the container starts; on the first WebUI visit the First Run Wizard runs

Optional: native Unraid stats

If you want to feed the Mesh Unraid widget with live data (instead of HTTP pings only), enable the Unraid GraphQL Socket under "Show Advanced":

/var/run/unraid-api.sock  →  /var/run/unraid-api.sock  (read-only)

Prerequisite: plugin unraid-api is running (unraid-api status in the console). With this the widget delivers array state, container counts, VM counts and service status without an API key.

Alternatively: without the socket mount, connect via HTTP — Admin → Integrations → Unraid → Endpoint = http://192.168.x.x:1580 plus API key.

Installing Glances alongside Mesh

For live CPU/RAM bars in server cards see Glances. Also a 2-click process in the Apps tab.

Updating to a new version

Unraid handles this automatically:

1. Docker tab → click the container icon next to itsweber-mesh → Update Ready if available
2. Apply Update

Schema migrations run automatically on container start. Backups land under /mnt/user/appdata/itsweber-mesh/config.json.pre-vN — existing backups are never overwritten.

Troubleshooting

"Cannot connect to WebUI"

• Check if the container is running: docker ps | grep itsweber-mesh
• Check logs: docker logs itsweber-mesh --tail 50
• If the UI stays blank after "Apply" — usually MESH_SESSION_SECRET is missing. The bootstrap script refuses to start and writes a log message.

"Image pull failed"

• Check DNS on the Unraid server: Settings → Network Settings → DNS Server → 192.168.x.x (your router) or 8.8.8.8
• docker pull hello-world tests the registry connection

Container starts but migration does not run

• Check logs for the Config migrated and persisted line
• If there is a schema mismatch: restore the backup — cp /mnt/user/appdata/itsweber-mesh/config.json.pre-vN /mnt/user/appdata/itsweber-mesh/config.json, then restart the container

Submitting to Community Apps

If you want to maintain the XML yourself (instead of through the AppFeed maintainer): see docs/release-prep/unraid/PUBLISHING.md.