goodhallsolutions/fodaris-agent repository overview

⁠Fodaris Agent

Lightweight monitoring agent that collects system metrics and sends them to your Fodaris server. Built for Docker hosts where you want to monitor the underlying machine without installing anything on the host OS.

⁠What it collects

• CPU usage, load averages, per-core stats
• Memory and swap usage
• Disk usage, I/O, and SMART health
• Network interface traffic and errors
• Temperature sensors (CPU, GPU, drives)
• Running processes (top consumers)
• Docker container resource usage
• GPU metrics (NVIDIA, AMD, Intel)

All metrics are encrypted in transit with AES-256-GCM.

⁠Quick start

docker run -d --name fodaris-agent \
  --pid=host --network=host --privileged \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -e FODARIS_SERVER_URL=https://your-fodaris-server:8443 \
  -e FODARIS_TOKEN=your_token_here \
  -e FODARIS_ENDPOINT_NAME=my-server \
  goodhallsolutions/fodaris-agent:latest

⁠Setup

1. In your Fodaris dashboard, go to Settings > Endpoints
2. Add a new endpoint and copy the auth token
3. Run the container with the token and your server URL
4. The endpoint will appear in your dashboard within seconds

⁠Configuration

All settings via environment variables:

⁠Platforms

Multi-arch image supporting:

• linux/amd64 (Intel/AMD 64-bit)
• linux/arm64 (Raspberry Pi 4/5, ARM servers)

⁠Requirements

A running Fodaris server. Get the server image at goodhallsolutions/fodaris⁠.

⁠Links

• Website: https://fodaris.co.uk⁠
• Docs: https://docs.fodaris.co.uk⁠
• Server image: https://hub.docker.com/r/goodhallsolutions/fodaris⁠

Built and maintained by Goodhall Solutions Ltd.