xmr-remote-nodes/README.md

# XMR Remote Nodes

Source code of [https://xmr.ditatompel.com](https://xmr.ditatompel.com).

## Requirements

- Go >= 1.22
- Linux Machine (AMD64 or ARM64)
- MySQL/MariaDB (for server)
- [GeoIP Database](https://dev.maxmind.com/geoip/geoip2/geolite2/) (for server, optional). Place it to `./assets/geoip`, see [./internal/repo/geoip.go](./internal/repo/geoip.go).

## Installation

### For initial server setup:

1. Download [GeoIP Database](https://dev.maxmind.com/geoip/geoip2/geolite2/) and place it to `./assets/geoip`. (see [./internal/repo/geoip.go](./internal/repo/geoip.go)).
2. Copy `.env.example` to `.env` and edit it to match with server environment.
3. Build the binary with `make build`.
4. Run the service with `./bin/xmr-nodes-static-linux-<YOUR_CPU_ARCH> serve`.

To create admin user (for creating prober API key from Web-UI, execute `./bin/xmr-nodes-static-linux-<YOUR_CPU_ARCH> admin create`).

Systemd example: [./tools/resources/init/xmr-nodes-server.service](./tools/resources/init/xmr-nodes-server.service).

### For initial prober setup:

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`.
4. Run the service with `./bin/xmr-nodes-static-linux-<YOUR_CPU_ARCH> prober`.

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).
removing current page & next page in api response This response was used for my HTMX "infinite scroll" data, which is not used in this Svelte project. 2024-05-09 11:29:48 +00:00			`# XMR Remote Nodes`

			`Source code of [https://xmr.ditatompel.com](https://xmr.ditatompel.com).`
Adding GeoIP support 2024-05-04 19:20:54 +00:00
			`## Requirements`

Using slog for logging level The log level for the apps is using `log/slog` from Go standard library. This commit change log format for fiber http logger to match with the slog standard log format (date and time). This commit also remove `APP_DEBUG` field from config struct. TODO: Use `slog` for default app output. Note that in this commit, the `slog` output only implemented in `cron` "db migrate" and probe client. 2024-05-13 11:40:01 +00:00			`- Go >= 1.22`
removing current page & next page in api response This response was used for my HTMX "infinite scroll" data, which is not used in this Svelte project. 2024-05-09 11:29:48 +00:00			`- Linux Machine (AMD64 or ARM64)`
Using slog for logging level The log level for the apps is using `log/slog` from Go standard library. This commit change log format for fiber http logger to match with the slog standard log format (date and time). This commit also remove `APP_DEBUG` field from config struct. TODO: Use `slog` for default app output. Note that in this commit, the `slog` output only implemented in `cron` "db migrate" and probe client. 2024-05-13 11:40:01 +00:00			`- MySQL/MariaDB (for server)`
removing current page & next page in api response This response was used for my HTMX "infinite scroll" data, which is not used in this Svelte project. 2024-05-09 11:29:48 +00:00			- [GeoIP Database](https://dev.maxmind.com/geoip/geoip2/geolite2/) (for server, optional). Place it to `./assets/geoip`, see [./internal/repo/geoip.go](./internal/repo/geoip.go).
Adding GeoIP support 2024-05-04 19:20:54 +00:00
Adding systemd example for server service 2024-05-06 12:59:43 +00:00			`## Installation`
Adding GeoIP support 2024-05-04 19:20:54 +00:00
removing current page & next page in api response This response was used for my HTMX "infinite scroll" data, which is not used in this Svelte project. 2024-05-09 11:29:48 +00:00			`### For initial server setup:`
Adding systemd example for server service 2024-05-06 12:59:43 +00:00
feat: MySQL db migration Create database schema migration for this app that run when the `serve` command is executed. 2024-05-11 21:19:40 +00:00			1. Download [GeoIP Database](https://dev.maxmind.com/geoip/geoip2/geolite2/) and place it to `./assets/geoip`. (see [./internal/repo/geoip.go](./internal/repo/geoip.go)).
			2. Copy `.env.example` to `.env` and edit it to match with server environment.
			3. Build the binary with `make build`.
			4. Run the service with `./bin/xmr-nodes-static-linux-<YOUR_CPU_ARCH> serve`.
Adding systemd example for server service 2024-05-06 12:59:43 +00:00
Adding systemd service and timer for prober 2024-05-06 14:45:33 +00:00			To create admin user (for creating prober API key from Web-UI, execute `./bin/xmr-nodes-static-linux-<YOUR_CPU_ARCH> admin create`).

Adding systemd example for server service 2024-05-06 12:59:43 +00:00			`Systemd example: [./tools/resources/init/xmr-nodes-server.service](./tools/resources/init/xmr-nodes-server.service).`
Adding systemd service and timer for prober 2024-05-06 14:45:33 +00:00
removing current page & next page in api response This response was used for my HTMX "infinite scroll" data, which is not used in this Svelte project. 2024-05-09 11:29:48 +00:00			`### For initial prober setup:`
Adding systemd service and timer for prober 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`.
			4. Run the service with `./bin/xmr-nodes-static-linux-<YOUR_CPU_ARCH> prober`.

			`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).`