maximleus/hostinfo repository overview

⁠Quick reference

• Maintained by:
  Maksym Leus⁠

• Where to get help or file issues:
  GitHub Issues⁠

• Supported architectures:
  amd64, arm64

• Source of this description:
  docs repo's / directory⁠ (history⁠)

⁠Supported tags and respective Dockerfile links:

• latest, v1.0.0⁠

⁠What is HostInfo?

HostInfo is a lightweight, container-ready Go service that exposes structured system, runtime, and environment information through a Web dashboard and a versioned REST API (/api/v1).

It is designed for DevOps engineers, SREs, platform teams, automation systems, and homelab operators who need fast, portable host telemetry with zero external runtime dependencies.

⁠Key Features

• 🚀 Fast & minimal Go HTTP server
• 🌐 Clean Web dashboard & interactive Swagger API Docs (/swagger/index.html)
• ☁️ Cloud provider detection (AWS / GCP / Azure / Local)
• ☸️ Kubernetes-ready with built-in liveness & readiness probes
• 🔒 Zero external runtime dependencies

⁠How to use this image

⁠Run via Docker CLI

docker run -d \
  --name hostinfo \
  -p 8080:8080 \
  maximleus/hostinfo:latest

Access the dashboard at http://localhost:8080 and Swagger docs at http://localhost:8080/swagger/index.html.

⁠Run via Docker Compose

version: '3.9'

services:
  hostinfo:
    image: maximleus/hostinfo:latest
    container_name: hostinfo
    ports:
      - "8080:8080"
    environment:
      - HOSTINFO_PORT=8080
      - HOSTINFO_DEBUG=false
    restart: unless-stopped

Run docker compose up -d to start the service.

⁠Deploy to Kubernetes using Helm

helm upgrade --install hostinfo ./helm \
  --namespace hostinfo \
  --create-namespace

⁠Environment Variables

For advanced configuration, check the Configuration Guide⁠.

⁠License

View license information⁠ for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Go binaries, base OS packages, etc., along with any direct or indirect dependencies of the primary software being contained).

It is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.