Guide

changedetection.io explained: self-hosting a page monitor vs using a hosted one

PageWatch team · November 10, 2026 · 4 min read

Short answer: changedetection.io is a popular open-source website change monitor, licensed Apache-2.0. You run it yourself (Docker or Python's pip), open its web interface, add the pages to watch, and it notifies you through many channels when they change. Its README also offers a hosted subscription ($8.99 a month at the time of writing). Self-hosting suits technical users who want control and lots of options; a hosted tool suits people who just want an email when the right thing changes.

What changedetection.io does

From the project's README, the main features are:

  • Change detection with filters: CSS, XPath (1.0), JSONPath and jq are built in, so you can watch exactly the part of a page you care about.
  • Visual Selector: pick the element to watch by clicking it (this needs the Playwright browser fetcher).
  • Browser Steps: fill in fields and click buttons before a check runs.
  • Restock and price detection for single product pages.
  • Notifications through Apprise, which covers a long list of services including email, Discord, Slack and webhooks.

How to self-host it

The README documents three routes:

  1. Docker using the dgtlmoon/changedetection.io image, with docker run or Docker Compose (docker compose up -d).
  2. pip: pip3 install changedetection.io, then start it with a data folder and a port; the interface runs at http://127.0.0.1:5000.
  3. Windows: instructions are in the project wiki.

A minimal Docker Compose setup is a single service with a volume for its data and a published port. For JavaScript-heavy pages you add a browser container for the Playwright fetcher.

What self-hosting really costs

The software is free; running it isn't zero:

  • A machine that's always on: a small VPS, a home server or a NAS.
  • Updates and backups: you maintain the container and keep the data volume safe.
  • Reliability: if the machine sleeps or the network drops, checks stop.
  • Blocking: some sites block data-center IPs; the hosted plan advertises proxies for this.
  • Time: setting up notifications, selectors and browser fetchers takes an afternoon the first time.

For a developer who enjoys this, it's a great tool. For someone who wants to know when a sneaker restocks, it's a lot of setup.

A sample setup: watching one price

Whatever tool you use, the steps for a reliable price watch are the same:

  1. Open the product page and find the element that holds the price (right-click → Inspect). Note a selector such as .product-price or [itemprop=price].
  2. Add the page and set the filter to that selector, so reviews, banners and "people are viewing this" counters don't trigger alerts.
  3. Add a condition if the tool supports it: a number below your target, or the word "In stock".
  4. Choose a frequency: hourly for fast-moving items, daily otherwise.
  5. Send alerts somewhere you'll see them, and test once by checking the history after the first run.

Self-hosted vs hosted: how to choose

Self-hosted changedetection.io Hosted monitor
Setup Docker or pip, then configure Sign up, paste a URL
Control Full: filters, browser steps, any channel What the service offers
Maintenance Yours The provider's
Runs when your computer is off Only if the server is always on Yes
Cost Server + your time A subscription (often with a free tier)

Other models exist too: Distill, for example, has local monitors that run in your browser (which must stay open) and cloud monitors that run on its servers, with optional conditions on each change.

Where PageWatch fits

PageWatch is the "no setup" end of the spectrum: paste a public page, optionally a CSS selector, and a plain-English condition ("tell me when the price drops below $50"). It checks the page on a schedule, an AI model decides whether each change matches your condition, and you get one digest email with the lines that changed. It respects robots.txt and never logs in, so it doesn't do browser steps behind logins; if you need that, a self-hosted tool you control is the right choice for your own accounts.

Tips whichever tool you use

  • Watch the smallest part of the page that answers your question.
  • Avoid pages behind logins unless they are your own accounts and the site allows automation.
  • Respect robots.txt and don't check more often than you need.
  • Name your watches clearly ("Shop: size 42", "Acme: careers, design"), so alerts make sense at a glance.

FAQ

Is changedetection.io free? The software is open source (Apache-2.0). Running it costs a server and your time; the project also sells a hosted plan.

Does it work with JavaScript pages? Yes, with the Playwright browser fetcher, according to the README.

What's the simplest way to watch one page? A hosted monitor. PageWatch is free for three pages; see also website monitoring explained.

Sources