# 🚀 MeshDash Configuration Wizard

Complete setup for your Meshtastic dashboard

Step 1 of 9 Authentication

## 👤 Create Your Account

Set up your administrator credentials for accessing the dashboard.

Username * This will be used to log into the dashboard
Session Duration (minutes) How long before re-login is required (5-1440 min)
Password * Minimum 8 characters recommended
Confirm Password * Must match password above
Secret Key (Advanced) * Used for encrypting session cookies. A random value has been auto-generated.

## 🔌 Node Connection

Choose how to connect to your Meshtastic device.

Connection Type *
Serial (USB)
TCP (WiFi)
BLE (Bluetooth)
Serial Port * Common: /dev/ttyACM0, /dev/ttyUSB0, COM3, /tmp/ttyMeshtastic
IP Address * IP address of your Meshtastic node
TCP Port Default Meshtastic TCP port is 4403
Bluetooth MAC Address * MAC address of your Meshtastic device

## 🌐 Web Server Configuration

Configure the web interface and network analyzer ports.

Host Address 0.0.0.0 allows access from other devices on your network
Main Dashboard Port Port for the main dashboard interface
Network Analyzer Port Separate port for network analysis tools

## 💾 Database & Storage

Configure data storage and retention settings.

Main Database Path Path to the main dashboard database file
Network Database Path Path to the network analyzer database file
Live Packets Memory Limit Packets to keep in memory for live view (10-10000)
History Retention (days) Days to keep historical metrics (SNR, RSSI, Battery)

## ⚙️ System Settings

Configure logging and system behavior.

Log Level
Higher levels show fewer messages. Use DEBUG for troubleshooting.
💡 Tip: Start with INFO level for normal operation. Switch to DEBUG if you need to troubleshoot connection issues.

## 🗺️ Community API Integration

Connect to the meshdash.co.uk community map.

Enable Community API Integration
API Key Get your key from meshdash.co.uk
Map API Base URL Community map endpoint

## 🔒 Privacy & Location Settings

Control what data is shared and location privacy.

⚠️ Privacy Notice: These settings control what location data is shared with the community map.
Share my node's location
Share other nodes' locations
Location Privacy Offset
Enable location randomization
Slightly randomizes your location before sharing for privacy
Offset Distance (meters) How many meters to randomly offset your location (e.g., 150)

## ⏱️ Scheduler & Network Settings

Configure heartbeat intervals and network reliability.

Heartbeat Interval (minutes) How often to send heartbeats to API (1-60 min)
Maximum Retries Times to retry failed API connections (0-10)
Heartbeat API URL (Optional) Leave blank to use the same as Community Map API

### Network Reliability

Retry Delay (seconds) Wait time between retries (1-300 sec)
Connection Timeout (seconds) Max time to wait for connection (1-120 sec)
Read/Write Timeout (seconds) Maximum time for data transfer (1-300 seconds)

## ✅ Review Your Configuration

Please review all settings before saving your configuration.

### Authentication

Username
Session Duration

### Connection

Connection Type

### Web Server

Host
Main Dashboard Port
Network Analyzer Port

### Database & Storage

Main Database
Network Database
Live Packets Limit
History Retention

### System

Log Level

### Community API

Enabled
API Key

### Privacy & Location

Share Local Location
Share Other Locations
Location Offset

### Scheduler & Network

Heartbeat Interval
Max Retries
Retry Delay
Connection Timeout
Read/Write Timeout