This project is not affiliated with Redbelly. It is a community companion to Bellydash v2 - a map of mainnet nodes. For authoritative documentation and releases, use Redbelly’s official channels and redbelly.network.
A world map of Redbelly nodes: dashboard hosts, governors (distinct styling on the map and in the list), and a broader set of domains from the DNS scan - including hosts not yet added to monitoring.
The app is a standalone Next.js site: deploy it on a different machine from the main Bellydash app and wire data via HTTP API or the database.
- 2D map (Leaflet): marker clusters, zoom; governors use a different style (amber accent, diamond marker on the list).
- Single sidebar: search, All / Monitored / Governors filters, scrollable domain list; clicking a map marker scrolls the list to that host.
- Header: network stats (RPC), Dashboard link; Regions - dropdown of countries with node counts and emoji flags.
Data refreshes automatically (e.g. node list about every 30 s) so the map reflects the current state.
- Dashboard - monitored nodes (online / offline / unknown), via proxy to the main app or - optionally - direct Postgres reads.
- DNS list - hosts from the UDP 6540 set (
hosts/udp6540_latest.tsv, processed at build/sync); shown as a separate layer next to dashboard nodes. - Governors - list from the main app API; matched by hostname.
For data flow, tables, and GeoIP cache details, see readme_tech.md
You need Node.js 20+, Python 3 (for the DNS list sync script), and hosts/udp6540_latest.tsv before the first build.
cd map
cp .env.example .env.local # set at least NODES_API_UPSTREAM or DATABASE_URL
npm install
npm run devDefault URL: http://localhost:3101
For production, configure environment variables (see .env.example) and run npm run build and npm start - see readme_tech.md for PM2, deploy.sh, and DNS list update scripts.
- Node.js 20+, Python 3
- Optional: PostgreSQL (persistent GeoIP cache with
GEO_CACHE_USE_DATABASE=true)
MIT. See LICENSE (includes an Attribution section: if you reuse the project or a substantial part of it, we kindly ask you to include Bellydash © 2026 in a visible place such as docs or credits).
Questions, bug reports, or feedback?
