changedetection.io

changedetection.io (serviceId dgtlmoon-changedetectionio) watches web pages and APIs for changes and notifies you when something changes, for example a price, a stock status or text on a page. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance (Apache-2.0) with up to 5 GiB of storage per instance. It has no external dependencies, so no database is needed.

What it can do

  • Watch web pages, PDFs and JSON endpoints and check them at an interval you choose.
  • Focus on specific content with selectors and filters (XPath, CSS, JSONPath, jq, regex, ignore and extract rules).
  • Review diffs down to word, line or character level.
  • Trigger conditional notifications (keywords, thresholds such as price bounds).
  • Send alerts through many channels via Apprise (email, Discord, Slack, Telegram, webhooks and more), for example to ntfy running in OSC.
  • Manage watches through the web UI or the REST API.

Creating an instance

Store the web UI password as a service secret: create-service-secret with serviceId: "dgtlmoon-changedetectionio", name cdpassword and the password as value. Then call create-service-instance with serviceId: "dgtlmoon-changedetectionio":

{
  "name": "mywatcher",
  "AdminPassword": "{{secrets.cdpassword}}",
  "Timezone": "Europe/Stockholm",
  "LoggerLevel": "INFO"
}

Wait for the instance to be running (wait-for-service-ready) and use describe-service-instance to get the URL. The web UI asks for the password you set in AdminPassword. There is no default password, and the plain password is not kept: it is hashed when the instance starts.

CLI equivalent:

osc create dgtlmoon-changedetectionio mywatcher \
  -o AdminPassword="{{secrets.cdpassword}}" \
  -o Timezone="Europe/Stockholm" \
  -o LoggerLevel="INFO"

Options

Option Required Type Meaning
name Yes string Name of the instance. Alphanumeric, at most 20 characters.
AdminPassword Yes string, sensitive Password for the web UI login. Without one anyone with the URL can use the UI, so always set it. The OSC entrypoint hashes it (PBKDF2-SHA256) into SALTED_PASS at startup and does not keep the plain value.
FetchWorkers No string Number of pages fetched in parallel (FETCH_WORKERS), a whole number. Defaults to 5 when empty; lower values use less memory.
PageWatchLimit No string Maximum total number of watches (PAGE_WATCH_LIMIT), enforced in the UI, imports and the API. Empty or non-numeric means unlimited.
DisableVersionCheck No boolean Set to true to stop the app checking for new upstream releases (DISABLE_VERSION_CHECK). Off by default.
Timezone No string Default timezone as an IANA name, for example Europe/Stockholm (TZ). Used for watch schedules and date/time expressions in notifications. Defaults to UTC.
LoggerLevel No string Log verbosity (LOGGER_LEVEL), for example INFO or WARNING, case-insensitive. When empty the app logs at DEBUG, which is very verbose, so INFO is recommended.

AdminPassword is sensitive: use a service secret and {{secrets.NAME}} as the whole field value. Changing the secret later does not restart a running instance.

Using the instance

Open the instance URL and log in. Paste the URL of the page to monitor into the input field on the front page and click "Watch". Open the watch settings to configure the check interval and notification URLs.

Resources