mirror of
https://github.com/l5yth/potato-mesh.git
synced 2026-07-05 01:11:58 +02:00
l5y
62de1480f7
* Require time library for ISO timestamp formatting * Default to host networking in Compose
98 lines
1.8 KiB
Markdown
98 lines
1.8 KiB
Markdown
# PotatoMesh Docker Setup
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
./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:
|
|
|
|
```bash
|
|
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:**
|
|
```bash
|
|
# Linux
|
|
ls /dev/ttyACM* /dev/ttyUSB*
|
|
|
|
# macOS
|
|
ls /dev/cu.usbserial-*
|
|
|
|
# Windows
|
|
ls /dev/ttyS*
|
|
```
|
|
|
|
**Set permissions (Linux/macOS):**
|
|
```bash
|
|
sudo chmod 666 /dev/ttyACM0
|
|
# Or add user to dialout group
|
|
sudo usermod -a -G dialout $USER
|
|
```
|
|
|
|
## Common Commands
|
|
|
|
```bash
|
|
# 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:**
|
|
```bash
|
|
# Check device exists and permissions
|
|
ls -la /dev/ttyACM0
|
|
|
|
# Fix permissions
|
|
sudo chmod 666 /dev/ttyACM0
|
|
```
|
|
|
|
**Port conflicts:**
|
|
```bash
|
|
# Find what's using port 41447
|
|
sudo lsof -i :41447
|
|
```
|
|
|
|
**Container issues:**
|
|
```bash
|
|
# Check logs
|
|
docker-compose logs
|
|
|
|
# Restart services
|
|
docker-compose restart
|
|
```
|
|
|
|
For more Docker help, see [Docker Compose documentation](https://docs.docker.com/compose/). |