Callsign

Callsign monitors your public IP address and notifies when it changes.

Setup

A Discord Webhook is recommended for notifications.

Regardless of your chosen setup method, Callsign is intended for use with a task scheduler, such as cron.

Environment Variables:

• LOG_LEVEL: Loguru severity level to write to the console.
• LOG_DISCORD_WEBHOOK_URL: Discord Webhook URL to receive log events.
• LOG_DISCORD_WEBHOOK_LEVEL: Minimum Loguru severity level to forward to Discord.
• DISCORD_WEBHOOK_URL: Discord Webhook URL to receive IP address change notifications.
• SIMPLE_MODE: Omit all extra information from the Discord embed notification other than the IP address. Optional, default False.

Docker (Recommended)

Modify the following compose.yaml example file, then run docker compose up.

services:
  callsign:
    container_name: callsign
    image: ethanchrisp/callsign:latest
    environment:
      LOG_LEVEL: INFO
      LOG_DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/YYYYYYYY/YYYYYYYY
      LOG_DISCORD_WEBHOOK_LEVEL: WARNING
      DISCORD_WEBHOOK_URL: https://discord.com/api/webhooks/XXXXXXXX/XXXXXXXX

Standalone

Callsign is built for Python 3.12 or greater.

1. Install required dependencies using uv: uv sync
2. Rename .env_example to .env, then provide the environment variables.
3. Start Callsign: python callsign.py