potato-mesh/DOCKER.md

PotatoMesh Docker Setup

Quick Start

./configure.sh
docker-compose up -d
docker-compose logs -f

The default configuration attaches both services to the host network. This avoids creating Docker bridge interfaces on platforms where that operation is blocked. Access the dashboard at http://127.0.0.1:41447 as soon as the containers are running. On Docker Desktop (macOS/Windows) or when you prefer traditional bridged networking, start Compose with the bridge profile:

COMPOSE_PROFILES=bridge docker-compose up -d

Access at http://localhost:41447

Configuration

Edit .env file or run ./configure.sh to set:

• API_TOKEN - Required for ingestor authentication
• MESH_SERIAL - Your Meshtastic device path (e.g., /dev/ttyACM0)
• SITE_NAME - Your mesh network name
• MAP_CENTER_LAT/LON - Map center coordinates

Device Setup

Find your device:

# Linux
ls /dev/ttyACM* /dev/ttyUSB*

# macOS
ls /dev/cu.usbserial-*

# Windows
ls /dev/ttyS*

Set permissions (Linux/macOS):

sudo chmod 666 /dev/ttyACM0
# Or add user to dialout group
sudo usermod -a -G dialout $USER

Common Commands

# Start services
docker-compose up -d

# View logs
docker-compose logs -f

# Stop services
docker-compose down

# Stop and remove data
docker-compose down -v

# Update images
docker-compose pull && docker-compose up -d

Troubleshooting

Device access issues:

# Check device exists and permissions
ls -la /dev/ttyACM0

# Fix permissions
sudo chmod 666 /dev/ttyACM0

Port conflicts:

# Find what's using port 41447
sudo lsof -i :41447

Container issues:

# Check logs
docker-compose logs

# Restart services
docker-compose restart

For more Docker help, see Docker Compose documentation.