readme.md

IPHistory

The IPHistory project is a simple yet effective solution for tracking and logging the public IP address of your network. It periodically fetches the public IP address and logs it to a file, while also providing a web interface to view the IP history in a clean UI and an endpoint (/history) for JSON format.

Running Locally

With Docker

git clone https://github.com/skidoodle/iphistory
cd iphistory
docker build -t iphistory:main .
docker run -p 8080:8080 iphistory:main

Without Docker

git clone https://github.com/skidoodle/iphistory
cd iphistory
go run main.go

Deploying

Docker Compose

version: '3.9'

services:
  iphistory:
    image: ghcr.io/skidoodle/iphistory:main
    container_name: iphistory
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - iphistory_data:/app

volumes:
  iphistory_data:
    external: false

Docker Run

docker run \
  -d \
  --name=iphistory \
  --restart=unless-stopped \
  -p 8080:8080 \
  ghcr.io/skidoodle/iphistory:main

License

GPL-3.0