Server-Gen is a multi-platform Go application that collects system metrics (IP, OS, CPU, memory, users) and emails a templated report on a configurable schedule. It also exposes a /healthz endpoint for basic health checks.
- Cron-style scheduling (
@every 30m,0 8 * * *, etc.) - Collects:
- Network interfaces & IPs
- Hostname & OS version
- CPU utilization
- Memory usage
- Active users
- Sends HTML/text email via SMTP with TLS + retry
- Configuration via YAML + environment‐variable overrides
- Built-in HTTP health endpoint (
/healthz) - Structured JSON+console logging (zerolog)
- Docker multi-stage build
- CI with GitHub Actions (matrix builds, tests, linting)
server-gen/
├── .github/
│ └── workflows/ci.yml
├── cmd/
│ └── server-gen/
│ └── main.go
├── configs/
│ └── config.yaml
├── internal/
│ ├── config/
│ │ └── config.go
│ ├── mailer/
│ │ └── mailer.go
│ └── sysinfo/
│ └── sysinfo.go
├── Dockerfile
├── go.mod
└── README.md
- Go ≥ 1.21
- Docker (optional)
- SMTP server (StartTLS or SMTPS)
# Clone the repo
git clone https://github.com/bocaletto-luca/server-gen.git
cd server-gen
# Build binary
go build -o server-gen ./cmd/server-genCopy configs/config.yaml and fill in your settings. You can also override any value via environment variables.
# configs/config.yaml
schedule: "@every 30m"
smtp:
host: "${SMTP_HOST}"
port: ${SMTP_PORT}
username: "${SMTP_USER}"
password: "${SMTP_PASS}"
from: "${SMTP_FROM}"
to:
- "${SMTP_TO1}"
- "${SMTP_TO2}"
modules:
- ip
- os
- cpu
- mem
- users
http:
addr: ":8080"Env vars
export SMTP_HOST=smtp.example.com
export SMTP_PORT=587
export SMTP_USER=alert@example.com
export SMTP_PASS=supersecret
export SMTP_FROM=alert@example.com
export SMTP_TO1=admin1@example.com
export SMTP_TO2=admin2@example.com./server-gen --config configs/config.yaml- The app starts an HTTP server on
http://localhost:8080/healthz. - It schedules jobs per
schedulein the config. - Each run gathers metrics and emails the report.
Build and run with Docker:
# Build image
docker build -t bocaletto-luca/server-gen .
# Run container
docker run -d \
-v $(pwd)/configs/config.yaml:/app/configs/config.yaml:ro \
-e SMTP_HOST -e SMTP_PORT -e SMTP_USER -e SMTP_PASS \
-e SMTP_FROM -e SMTP_TO1 -e SMTP_TO2 \
--name server-gen \
bocaletto-luca/server-gen- Unit tests:
go test ./internal/config go test ./internal/sysinfo go test ./internal/mailer
- Lint & vet:
go vet ./...
- GitHub Actions runs tests & builds for Go 1.19–1.21.
- Fork the repository
- Create a feature branch (
git checkout -b feat/your-feature) - Commit your changes (
git commit -m "feat: ..."); run tests - Push to your branch (
git push orig 62B7 in feat/your-feature) - Open a Pull Request
This project is licensed under the MGPL License.
See LICENSE for details.