MESHDASH // SETUP
INITIALIZING...

Installation Type

Configure your MeshDash installation and generate a single command to set everything up on your device.

Currently Supported
Ubuntu Debian Raspberry Pi OS Windows (WSL) Docker
Future Support
Windows • macOS
Hardware Recommendation: We recommend a Raspberry Pi 3B+ or newer (4GB+ RAM preferred) for optimal performance.
NEW INSTALLATION
First‑time setup — create a new admin account
UPGRADE / REINSTALL
Load existing configuration from our servers
OFFLINE / MANUAL
No account required. Download files manually.
Select an option to continue.

Welcome to MeshDash

This wizard configures three things:

YOUR LOGIN
Admin account for your local dashboard
RADIO LINK
Connect to your Meshtastic radio
REMOTE ACCESS
Access your dashboard from anywhere
At the end you'll receive a single command to paste into your device's terminal. It downloads, configures, and starts everything automatically.
MeshDash Version
Version Details

Dashboard Login

Create the admin account for your local MeshDash dashboard.

These credentials are used to log in to your local MeshDash panel (e.g. http://your-device-ip:8000). Think of it like your router's admin page.
Login Credentials
Your username for the local dashboard. Also used for account recovery.
Address (Optional)
Provide my address
Helps us understand how MeshDash is used geographically and improves the community mesh map by showing nodes in your local area. Stored securely — never displayed publicly.
Session Security
Signs your login sessions (JWT). Never leaves your device. Changing it logs everyone out.
How long you stay logged in before re-authentication is required.

Radio Interface

How is your Meshtastic radio connected to the device running MeshDash?

Linux/Pi: typically /dev/ttyACM0 or /dev/ttyUSB0. Windows: COM3. Run ls /dev/tty* to find yours.

Hosting & Storage

Web server and data storage settings for your device.

Web Server
Who can reach the dashboard on your local network.
Access your panel at http://device-ip:8000.
Install Systemd Service
Automatically configure MeshDash to start on boot.
Data Retention
Older messages, packets, and telemetry are automatically deleted.
Recent packets held in memory for the live dashboard feed.
Database Files
File paths on your device. Defaults are fine for most installations.

Community & Remote Access

Appear on the public mesh map and access your dashboard remotely — no port forwarding or VPN required.

Enable Community Map & Remote Access
Your node will appear on the MeshDash map and you'll be able to access your dashboard remotely via meshdash.co.uk.

Remote Access Control ✓ RECOMMENDED

Controls what is accessible when you access your node remotely via meshdash.co.uk. Your local dashboard is always fully accessible regardless of these settings.

Enabled Remotely

Blocked Remotely

System config, login, and setup endpoints are always blocked over C2.
ADVANCED: Manual Endpoint Overrides
Most users should leave this alone. The access level above sets sensible defaults.
Pipe-separated list. Overrides everything above.

System Tuning

Radio connection scheduler settings. Defaults are recommended for most setups.

Retry attempts when the radio connection fails.
Wait time between retry attempts.
Max time to wait when establishing a new radio connection.
Max time to wait for a read/write operation on an active connection.

Review & Deploy

Review your configuration and understand how your data is used.

Configuration Summary
What We Store & Why
Full transparency on your data:
    After Installation
    ✓ Admin user created on your device
    ✓ .mesh-dash_config generated
    ✓ Radio connection manager starts
    ✓ Database schemas initialised
    ✓ Dashboard accessible at http://device-ip:port
    LICENSE AGREEMENT

    1. Use granted under MIT License.
    2. No liability for hardware damage.
    3. Privacy: Data stays local unless C2/Community enabled.
    4. When C2 is enabled, data transits through meshdash.co.uk servers.
    5. Security: Protect your API key and auth secret.
    6. Personal data stored on MeshDash servers for account & config recovery.
    7. PROVIDED "AS IS", NO WARRANTY.
    I accept the License Agreement and understand how my data is stored and used.

    Saving Configuration

    Generating your installer...