HONKIP

Setup guides

Pick the device that's always on at home. Each guide has the exact settings to type and a way to check it worked.

Make a free account and your own name and update key are filled into every guide.Get a free name

Docker

Below, yourname.honkip.com and YOUR_UPDATE_KEY stand for your own name and update key.

Runs on any machine with Docker, such as a NAS, home server or Raspberry Pi. It keeps running after restarts.

  1. Make a folder, and save this as compose.yaml in it:
    services: honkip: image: alpine:3.20 container_name: honkip restart: unless-stopped command: > sh -c 'apk add --no-cache curl >/dev/null; while true; do curl -fsS "https://update.honkip.com/update?key=YOUR_UPDATE_KEY"; echo; sleep 300; done'
  2. Start it from that folder: docker compose up -d
  3. See that it works: docker logs honkip shows good or nochg every 5 minutes.

No compose? The same in one line: docker run -d --name honkip --restart unless-stopped alpine:3.20 sh -c 'apk add --no-cache curl >/dev/null; while true; do curl -fsS "https://update.honkip.com/update?key=YOUR_UPDATE_KEY"; echo; sleep 300; done'. To remove it: docker rm -f honkip

Check it worked

  1. The test command prints good or nochg and your address. badauth means the update key is wrong; copy it again.
  2. Once you have an account, Last check-in on My home shows when it last worked.
  3. Look your name up from any computer: nslookup yourname.honkip.com. The address it shows should be your home's address.