XMR Remote Nodes

Source code of https://xmr.ditatompel.com, a website that helps you monitor your favourite Monero remote nodes.

How does it work?

Apart from CPU architecture type, you can build two types of binaries from this project: a server and a client.

The clients is used to fetch node information given by the server. First, it will ask the server which node to fetch. Then, it will fetch the information and report back to the server.

The server serves an embedded Svelte static site for the Web UI. It also serves the /api endpoint that is used by the clients and the Web UI itself.

Requirements

Server & Prober requirements

Go >= 1.22
Linux Machines (AMD64 or ARM64)

Server requirements

MySQL/MariaDB
GeoIP Database (optional). Place it to ./assets/geoip, see ./internal/geo/ip.go.

Installation

For initial server setup:

Download GeoIP Database and place it to ./assets/geoip. (see ./internal/geo/ip.go).
Copy .env.example to .env and edit it to match with server environment.
Build the binary with make build.
Run the service with ./bin/xmr-nodes-server-linux-<YOUR_CPU_ARCH> serve.

Systemd example: ./deployment/init/xmr-nodes-server.service.

For initial prober setup:

Create API key for prober
Copy .env.example to .env and edit it to match with prober environment.
Build the binary with make build.
Run the service with ./bin/xmr-nodes-client-linux-<YOUR_CPU_ARCH> probe.

Systemd example: xmr-nodes-prober.service and xmr-nodes-prober.timer.

Development and Deployment

See the Makefile.

1.9 KiB Raw Blame History