MeshDash Easy Installer

Installation Options

Welcome to the Mesh Dash Installation Tool! This utility helps you quickly set up and configure Mesh Dash.

Choose your preferred installation method below based on your Operating System:

Generate a one-line command to install MeshDash directly on native Debian-based Linux systems (like Ubuntu, Debian).

If you are using a Raspberry Pi, please use the dedicated Raspberry Pi tab. For Windows, use the Windows (WSL) tab.

System Requirements: Python 3.9+ required (installer attempts to install it).

View detailed Python dependencies

Your Meshtastic device must be:

Configured & working (Firmware 2.6+ Recommended)
Connected to the same Wi-Fi network as this computer
Mesh Dash is in early release. Feedback welcome!

Choose the version to install. Latest is recommended.

The IP address of your Meshtastic device on your local network.

Usually 4403. Change only if you modified the device config.

Use 0.0.0.0 for all network interfaces, or specify an IP.

Port to access MeshDash in your browser (e.g., http://your-server:8080).

Starts MeshDash automatically on system boot.

How to use (Linux):

  1. Select desired MeshDash version
  2. Fill in device & server details
  3. Click "Generate Linux Command"
  4. Copy the generated command below
  5. Paste and run it in your Linux terminal

Note: Requires internet access and potentially `sudo` privileges.

Linux command copied to clipboard!

Generate a one-line command to install MeshDash directly on your Raspberry Pi running Raspberry Pi OS (or other compatible Debian-based systems).

Alpha Version: This Raspberry Pi installation path is new and has not been as widely tested as the standard Linux method. Please report any issues.

This method is ideal for dedicated Pi setups acting as MeshDash servers.

System & Hardware Recommendations:
  • OS: Raspberry Pi OS (Legacy/Lite or Desktop) based on Debian is recommended.
  • Python: Python 3.9+ required (installer attempts to install it).
  • Model: Raspberry Pi 3B+ or newer recommended. Pi 4 / Pi 5 offer significantly better performance for larger meshes.
  • RAM: 1GB minimum (Pi 3B+), but 2GB or more recommended for smoother operation, especially if running other services.
  • SD Card: Use a reliable Class 10/U1/A1 (or better) SD card, 16GB or larger. Performance and reliability vary greatly between cards.
  • Power Supply: A stable, high-quality power supply matched to your Pi model (e.g., Official 2.5A for Pi 3B+, 3A+ for Pi 4/5) is crucial. Undervoltage causes instability.
  • Cooling (Optional): For continuous use, especially on Pi 4/5, passive (heatsinks) or active (fan) cooling is advised to prevent thermal throttling.

View detailed Python software dependencies

Your Meshtastic device must be:

Configured & working (Firmware 2.6+ Recommended)
Connected to the same Wi-Fi network as your Raspberry Pi
Mesh Dash is in early release. Feedback welcome!

Choose the version to install. Latest is recommended.

The IP address of your Meshtastic device on your local network.

Usually 4403. Change only if you modified the device config.

Use 0.0.0.0 to listen on all Pi's network interfaces, or specify one IP.

Port to access MeshDash in your browser (e.g., http://raspberrypi.local:8080 or http://PI_IP_ADDRESS:8080).

Starts MeshDash automatically when your Raspberry Pi boots.

How to use (Raspberry Pi):

  1. Select desired MeshDash version
  2. Fill in device & server details
  3. Click "Generate Raspberry Pi Command"
  4. Copy the generated command below
  5. Paste and run it in your Raspberry Pi terminal (SSH or direct)

Note: Requires internet access and potentially `sudo` privileges on the Pi.

Raspberry Pi command copied to clipboard!

Generate `docker-compose.yml` and `Dockerfile` to run MeshDash in a container using Docker.

System Requirements: Docker and Docker Compose (or `docker compose` command) must be installed.

Visit the official Docker website for installation instructions.

Your Meshtastic device must be:

Configured & working (Firmware 2.6+ Recommended)
Connected to the same network reachable by the Docker host
Mesh Dash is in early release. Feedback welcome!

Choose the version for the Docker image. Latest recommended.

IP address of your Meshtastic device (must be reachable from Docker host).

Usually 4403.

The port you'll access MeshDash on your *host* machine (e.g., http://localhost:8080). Ensure this port is free.

How to use (Docker):

  1. Ensure Docker & Docker Compose are installed.
  2. Select MeshDash version & fill details.
  3. Click "Generate Docker Files".
  4. Create a new empty directory (e.g., `mesh-dash-docker`).
  5. Save the generated `Dockerfile` content into a file named `Dockerfile` **(no extension)** inside the new directory.
  6. Save the generated `docker-compose.yml` content into a file named `docker-compose.yml` inside the new directory.
  7. Open a terminal **inside that directory**.
  8. Run `docker compose build` to build the image.
  9. Run `docker compose up -d` to start MeshDash in the background.
  10. Access MeshDash at `http://:` (e.g., `http://localhost:8080` if running locally on port 8080).

Note: The Web Server Binding Address is fixed to `0.0.0.0` inside the container.

Generate a one-line command to install MeshDash on Windows using the Windows Subsystem for Linux (WSL) with a Debian-based distribution like Ubuntu.

Setting up WSL

Windows Subsystem for Linux (WSL) lets you run a genuine Linux environment directly on Windows. Use Ubuntu (installed by default with the command below) for best compatibility.

  1. Install WSL & Ubuntu: Open **PowerShell** or **Command Prompt** as **Administrator** (Right-click Start -> Terminal (Admin)). Run the command: wsl --install. Follow any prompts. A system restart is usually required.
  2. First-Time Ubuntu Setup: After restarting, find and launch **Ubuntu** from the Windows Start Menu. It will perform a one-time setup. You'll be prompted to create a **Linux username** and **password** (these are separate from your Windows login).
  3. Ready to Install: Once you see the Ubuntu command prompt (e.g., user@hostname:~$), you can proceed with generating and running the installation command below within this Ubuntu terminal.

Note: If `wsl --install` doesn't install Ubuntu, use wsl --install -d Ubuntu in an Admin terminal first. You can check installed distributions with wsl -l -v.

System Requirements (within WSL): Python 3.9+ required (installer attempts to install it in the WSL environment).

View detailed Python dependencies

Your Meshtastic device must be:

Configured & working (Firmware 2.6+ Recommended)
Connected to the same Wi-Fi network as your Windows computer
Mesh Dash is in early release. Feedback welcome!

Choose the version to install inside WSL. Latest is recommended.

The IP address of your Meshtastic device on your local network.

Usually 4403. Change only if you modified the device config.

Use 0.0.0.0 for all network interfaces within WSL, or specify a specific WSL IP.

Port to access MeshDash from your Windows browser (e.g., http://localhost:8080). WSL forwards ports automatically.

Starts MeshDash automatically within WSL. Requires recent WSL versions with systemd enabled. Select "No" if unsure or running manually is preferred.

How to use (WSL):

  1. Ensure WSL and Ubuntu are set up (see above).
  2. Select desired MeshDash version.
  3. Fill in device & server details.
  4. Click "Generate WSL Install Command".
  5. Copy the generated command below.
  6. Paste and run it inside your **Ubuntu WSL terminal**.
  7. If systemd was set to 'Yes', it should start automatically after install/reboot. If 'No', navigate to the install dir (`~/mesh-dash`) and run manually (`python meshtastic_dashboard.py`).
  8. Access in your Windows browser via `http://localhost:` (e.g., http://localhost:8080).

Note: Requires internet access within WSL and potentially `sudo` privileges for the Linux user you created.

WSL install command copied to clipboard!

Download a Windows batch installer (.bat) to set up MeshDash directly on your Windows system.

System Requirements: Python 3.9+ required (installer attempts to install it).

View detailed Python dependencies

Your Meshtastic device must be:

Configured & working (Firmware 2.6+ Recommended)
Connected to the same Wi-Fi network as your Windows computer
Mesh Dash is in early release. Feedback welcome!

Choose the version to install. Latest is recommended.

The IP address of your Meshtastic device on your local network.

Usually 4403. Change only if you modified the device config.

Use 0.0.0.0 for all network interfaces, or specify an IP.

Port to access MeshDash in your browser (e.g., http://localhost:8080).

How to use (Windows):

  1. Select desired MeshDash version
  2. Fill in device & server details
  3. Click "Download Windows Installer"
  4. Save the .bat file to your computer
  5. Right-click the downloaded file and select "Run as administrator"
  6. Follow the on-screen instructions
  7. Access MeshDash in your browser using the configured port

Note: The installer will handle Python setup, dependencies installation, and MeshDash configuration.