MeshCore Wardrive Map — Self-Hosted (Docker)

Self-hosted version of the MeshCore wardrive coverage map. Runs locally with SQLite — no cloud dependencies.

Quick Start

git clone https://github.com/mintylinux/meshwar-map-docker.git
cd meshwar-map-docker
docker compose up -d

Open http://localhost:3000 in your browser.

Features

• Same map interface as the community map
• SQLite backend — single-file database, no external services
• Manual import tool — vet and validate data before adding
• Contributor tracking — track who contributed what data
• Leaderboard API — per-contributor stats
• Upload control — app uploads disabled by default (security-first)
• Docker volume — database persists across restarts

Importing Data

Interactive Import (Recommended)

1. Export data from the MeshCore Wardrive app (Settings > Export Data > JSON)
2. Copy the JSON file to the tools/ directory
3. Run the import script:

cd tools && bash import.sh

# Or inside Docker:
docker exec -it meshwar-map bash -c "cd /app/tools && bash import.sh"

Direct Import (Non-Interactive)

node tools/import.js mydata.json --contributor Chuck --region WA

Options: --dry-run, --contributor NAME, --region CODE

App Upload (Optional)

Set ALLOW_UPLOAD=true in docker-compose.yml, then add your server as an upload endpoint in the app: http://your-server:3000/api/samples

Only enable on trusted networks — there is no authentication.

API Endpoints

• GET /api/samples — Coverage data for the map
• POST /api/samples — Upload samples (requires ALLOW_UPLOAD=true)
• GET /api/stats — Global statistics
• GET /api/contributors — Contributor leaderboard

Environment Variables

• PORT (default: 3000) — Server port
• ALLOW_UPLOAD (default: false) — Enable app uploads
• DB_PATH (default: /app/data/meshwar.db) — Database path

Reverse Proxy

Use nginx or nginx-proxy-manager to expose on your domain with HTTPS:

server {
    listen 443 ssl;
    server_name map.yourdomain.com;
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Data Storage

Database: data/meshwar.db (SQLite, persisted via Docker volume)

Archived imports: data/processed/2026-04-15-Chuck-WA-342pings.json

License

MIT