Installation

• Docker
• Docker Compose
• APT (Ubuntu, Debian)
• RPM (CentOS, RHEL)
• AUR (Arch Linux)
• Homebrew (macOS, Linux)
• Kubernetes
• Manual Installation
• Local Build

Docker

A Docker image is available at ghcr.io/gabe565/domain-watch.

Here's an example command that will watch example.com and example.org domains, and sends notifications to Telegram.

sudo docker run -d \
  -e WATCH_DOMAINS='example.com example.org'\
  -e WATCH_TELEGRAM_TOKEN='TOKEN' \
  -e WATCH_TELEGRAM_CHAT='CHAT_ID' \
  ghcr.io/gabe565/domain-watch

Docker Compose

First you will need a docker-compose.yaml file, such as the one included in this repo. Run the below command as root or a member of the docker group:

sudo docker compose up -d

APT (Ubuntu, Debian)

1. If you don't have it already, install the ca-certificates package

   sudo apt install ca-certificates

2. Add gabe565 apt repository

   echo 'deb [trusted=yes] https://apt.gabe565.com /' | sudo tee /etc/apt/sources.list.d/gabe565.list

3. Update apt repositories

   sudo apt update

4. Install Domain Watch

   sudo apt install domain-watch

RPM (CentOS, RHEL)

1. If you don't have it already, install the ca-certificates package

   sudo dnf install ca-certificates

2. Add gabe565 rpm repository to /etc/yum.repos.d/gabe565.repo

   [gabe565]
   name=gabe565
   baseurl=https://rpm.gabe565.com
   enabled=1
   gpgcheck=0

3. Install Domain Watch

   sudo dnf install domain-watch

AUR (Arch Linux)

Install domain-watch-bin with your AUR helper of choice.

Homebrew (macOS, Linux)

Install Domain Watch from gabe565/homebrew-tap:

brew install gabe565/tap/domain-watch

Kubernetes

A Helm chart is available to make Kubernetes simplify deployment to Kubernetes.

helm install domain-watch oci://ghcr.io/gabe565/charts/domain-watch

For more information, see charts.gabe565.com or Artifact Hub.

Manual Installation

Download and run the latest release binary for your system and architecture.

Local Build

# Compile the app
go install github.com/gabe565/domain-watch@latest

# Domain Watch will be installed to your Go bin path.
domain-watch --help