🔔 Get notified instantly when your dream domain becomes available!

A powerful Python CLI tool that monitors domain availability across multiple TLDs and sends real-time alerts via Telegram, Discord, Email, or Webhooks.

• Never miss a domain drop - Get instant notifications when domains become available
• No false positives - Two-source verification (RDAP + WHOIS) ensures accuracy
• Multiple alert channels - Telegram, Discord, Email, or custom webhooks
• Set it and forget it - Run on a schedule and get notified automatically
• Privacy-focused - Self-hosted, your data stays with you

git clone https://github.com/FlexKleks/DomainChecker.git
cd DomainChecker
pip install -e .

cp config.example.json config.json
# Edit config.json - add your Telegram token, domains, etc.

cp domains.example.txt domains.txt
# Add domains to monitor (one per line)

python -m domain_checker.cli check-list domains.txt --config config.json

🟢 Domain available!

Domain: mydream-domain.com
Status: Available
Time: Dec 10, 2025, 5:30 AM

{
  "language": "en",
  "notifications": {
    "telegram": {
      "enabled": true,
      "bot_token": "YOUR_BOT_TOKEN",
      "chat_id": "YOUR_CHAT_ID"
    }
  }
}

"discord": {
  "enabled": true,
  "webhook_url": "https://discord.com/api/webhooks/..."
}

# Check single domain
python -m domain_checker.cli check example.com --config config.json

# Check multiple domains
python -m domain_checker.cli check-list domains.txt --config config.json

# Test mode (no real requests)
python -m domain_checker.cli check example.com --dry-run

# Verify connectivity
python -m domain_checker.cli self-test --config config.json

# Create scheduled task to run every 6 hours
python -m domain_checker.cli check-list domains.txt --config config.json

# Every 6 hours
0 */6 * * * cd /path/to/DomainChecker && python -m domain_checker.cli check-list domains.txt --config config.json

[Unit]
Description=Domain Availability Checker
After=network.target

[Service]
Type=oneshot
User=your-user
WorkingDirectory=/path/to/DomainChecker
ExecStart=/usr/bin/python3 -m domain_checker.cli check-list domains.txt --config config.json

[Unit]
Description=Run Domain Checker every 6 hours

[Timer]
OnBootSec=5min
OnUnitActiveSec=6h
Persistent=true

[Install]
WantedBy=timers.target

sudo systemctl daemon-reload
sudo systemctl enable domain-checker.timer
sudo systemctl start domain-checker.timer

cd /home/container && pip install -e . && python -m domain_checker.cli check-list domains.txt --config config.json

#!/bin/bash
cd /home/container

# Install dependencies (first run only)
if [ ! -d "venv" ]; then
    python3 -m venv venv
    source venv/bin/activate
    pip install -e .
else
    source venv/bin/activate
fi

# Run the checker in a loop
while true; do
    echo "[$(date)] Starting domain check..."
    python -m domain_checker.cli check-list domains.txt --config config.json
    echo "[$(date)] Check complete. Sleeping for 6 hours..."
    sleep 21600  # 6 hours in seconds
done

python -m domain_checker.cli check-list domains.txt --config config.json

/home/container/
├── config.json          # Your configuration
├── domains.txt          # Domains to monitor
├── start.sh             # Startup script (optional)
├── src/
│   └── domain_checker/  # Application code
└── .domain_checker/     # State files (auto-created)

docker run -v ./config.json:/app/config.json flexkleks/domain-checker

📋 See SUPPORTED_TLDS.md for the complete list with RDAP/WHOIS endpoints.

Contributions are welcome! See CONTRIBUTING.md for guidelines.

• ⭐ Star this repo if you find it useful!
• 🐛 Report bugs via Issues
• 💡 Request features via Issues
• 🔀 Submit PRs for improvements

MIT License - Free for personal and commercial use.

If this project helped you, please consider giving it a ⭐!

Made with ❤️ by FlexKleks