2024-05-09 11:29:48 +00:00
# XMR Remote Nodes
2024-05-17 10:40:22 +00:00
Source code of [https://xmr.ditatompel.com ](https://xmr.ditatompel.com ), a website that helps you monitor your favourite Monero remote nodes.
2024-05-04 19:20:54 +00:00
## Requirements
2024-05-17 10:40:22 +00:00
### Server & Prober requirements
2024-05-13 11:40:01 +00:00
- Go >= 1.22
2024-05-09 11:29:48 +00:00
- Linux Machine (AMD64 or ARM64)
2024-05-17 10:40:22 +00:00
### Server requirements
- MySQL/MariaDB
2024-05-22 20:40:06 +00:00
- [GeoIP Database ](https://dev.maxmind.com/geoip/geoip2/geolite2/ ) (optional). Place it to `./assets/geoip` , see [./internal/geo/ip.go ](./internal/geo/ip.go ).
2024-05-04 19:20:54 +00:00
2024-05-06 12:59:43 +00:00
## Installation
2024-05-04 19:20:54 +00:00
2024-05-09 11:29:48 +00:00
### For initial server setup:
2024-05-06 12:59:43 +00:00
2024-05-22 20:40:06 +00:00
1. Download [GeoIP Database ](https://dev.maxmind.com/geoip/geoip2/geolite2/ ) and place it to `./assets/geoip` . (see [./internal/geo/ip.go ](./internal/geo/ip.go )).
2024-05-11 21:19:40 +00:00
2. Copy `.env.example` to `.env` and edit it to match with server environment.
3. Build the binary with `make build` .
2024-05-18 11:05:53 +00:00
4. Run the service with `./bin/xmr-nodes-server-linux-<YOUR_CPU_ARCH> serve` .
2024-05-06 12:59:43 +00:00
2024-05-22 17:39:31 +00:00
To create admin user (for creating proberAPI key from Web-UI, execute `./bin/xmr-nodes-server-linux-<YOUR_CPU_ARCH> admin create` ).
2024-05-06 14:45:33 +00:00
2024-05-06 12:59:43 +00:00
Systemd example: [./tools/resources/init/xmr-nodes-server.service ](./tools/resources/init/xmr-nodes-server.service ).
2024-05-06 14:45:33 +00:00
2024-05-09 11:29:48 +00:00
### For initial prober setup:
2024-05-06 14:45:33 +00:00
1. Create API key for prober
2. Copy `.env.example` to `.env` and edit it to match with prober environment.
3. Build the binary with `make build` .
2024-05-18 11:05:53 +00:00
4. Run the service with `./bin/xmr-nodes-client-linux-<YOUR_CPU_ARCH> probe` .
2024-05-06 14:45:33 +00:00
Systemd example: [xmr-nodes-prober.service ](./tools/resources/init/xmr-nodes-prober.service ) and [xmr-nodes-prober.timer ](./tools/resources/init/xmr-nodes-prober.timer ).