Meshquake (Docker Edition)

Meshquake monitors real-time earthquakes via USGS and sends alerts over Meshtastic mesh radios.

---

🔧 What It Does

• Polls the USGS real-time earthquake feed
• Filters quakes by:
  • ZIP code location
  • Radius (in miles)
  • Minimum magnitude
• Sends messages via Meshtastic CLI
• Stores quake history in SQLite
• Logs activity and errors
• Fully containerized with Docker + Compose
• Persistent logs and DB outside container

---

🚀 One-Click Deployment

Prerequisites

• Docker
• Docker Compose

Clone and Run

git clone https://github.com/gsilvr/meshquake.git
cd meshquake
git checkout meshquake-docker
mkdir -p data
docker compose build
docker compose up -d

This will:

• Build the container
• Persist logs and DB to ./data/
• Run in prod mode with default flags (see below)

---

⚙️ Configuration

Edit docker-compose.yml to change runtime flags.

Example:

command: >
  prod --zip 95014 --min-mag 1.0 --max-distance 100
  --radio-ip 192.168.69.211 --ch-index 1

---

🔁 Runtime Modes

Mode	Description
dev	Dry run, log only
devsend	Sends to test radio, logs to separate dev table
prod	Full runtime, persistent logging + DB

---

🧾 Flags

Flag	Description
--zip	ZIP code for center location (required)
--min-mag	Minimum quake magnitude (e.g. 1.5)
--max-distance	Max radius in miles (default: 120)
--radio-ip	Target Meshtastic node IP
--ch-index	Channel index for sending (default: 0)

---

🗃 Persistent Output

All output is stored in the ./data directory:

• meshquake_error.log — logs
• earthquakes.db — SQLite DB of quake events

---

📤 Example Output

M2.3 88mi from Cupertino: 3 km W of Cobb, CA, 05-21 22:01 PDT

Long messages are chunked into:

Part 1: M2.3 88mi from Cupertino
Part 2: 3 km W of Cobb, CA
Part 3: 05-21 22:01 PDT

---

🧹 Reset State

To clear logs and DB:

rm -f data/earthquakes.db data/meshquake_error.log

---

🛑 Stop the Service

docker compose down

---

🛠 Maintenance Notes

• Logs rotate manually (watch file size)
• DB stores quake IDs to avoid duplicates
• prod polls every 60 seconds
• All files persist under ./data/

---

✅ Status

Stable • Dockerized • Ready for unattended use