Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Run the ghcr.io/mjaschen/urlwatch image with a host directory mounted at /data/urlwatch. The official Docker project uses ./data:/data/urlwatch; that mount keeps the job list, configuration, hooks, and cache outside the container so they remain available when it is recreated. Add your jobs to data/urls.yaml, configure a reporter in data/urlwatch.yaml, then start the service with Docker Compose.

What persists, and why the mount matters

Containers can be removed and recreated. Files written only inside a container may disappear with it. The urlwatch Docker project expects its working files under /data/urlwatch; mounting a host directory there preserves those files independently of the container.

The project’s scheduled command uses urls.yaml, urlwatch.yaml, hooks.py, and cache.db. Keep the whole working directory mounted, rather than preserving only the YAML configuration: the job definitions, optional hooks, and cache all belong to the same working set.

Prepare the data directory

  1. In a project directory, create the host-side data directory:

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
    #1 Best Overall
    CanaKit Raspberry Pi 5 Starter Kit PRO - Turbine Black (128GB Edition) (8GB RAM)
    • Includes Raspberry Pi 5 with 2.4Ghz 64-bit quad-core CPU (8GB RAM)
    • Includes 128GB Micro SD Card pre-loaded with 64-bit Raspberry Pi OS, USB MicroSD Card Reader
    • CanaKit Turbine Black Case for the Raspberry Pi 5
    • CanaKit Low Noise Bearing System Fan
    • Mega Heat Sink - Black Anodized
    mkdir -p data
  2. Put the jobs you want to monitor in data/urls.yaml. The Docker project points to its example jobs file and to urlwatch’s Jobs documentation for job syntax. Use job definitions appropriate to the urlwatch version in the image you run.

  3. Copy the project’s data/urlwatch.template.yaml to data/urlwatch.yaml, then configure at least one reporter if you want notifications. Reporter-specific settings go below the report key. Treat mail passwords, tokens, and other credentials as secrets; do not commit real credentials to a public repository.

  4. Add data/hooks.py if your setup uses hooks. The cache file, data/cache.db, is maintained as part of the working directory when urlwatch runs.

Urlwatch’s global configuration controls general behavior and reporters, while each job describes what to check. The urlwatch 2.29 configuration manual documents urlwatch --edit-config for editing the global configuration; check that the command and options match the urlwatch version included in your selected image. By default, the documented configuration reports new pages and errors, but not unchanged pages.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Run Urlwatch with Docker Compose

Create the Compose file

Save this minimal service definition as compose.yaml in the directory containing data/:

Rank #2
CanaKit Raspberry Pi 4 4GB Starter PRO Kit - 4GB RAM
  • Includes Raspberry Pi 4 4GB Model B with 1.5GHz 64-bit quad-core CPU (4GB RAM)
  • Includes Pre-Loaded 32GB EVO+ Micro SD Card (Class 10), USB MicroSD Card Reader
  • CanaKit Premium High-Gloss Raspberry Pi 4 Case with Integrated Fan Mount, CanaKit Low Noise Bearing System Fan
  • CanaKit 3.5A USB-C Raspberry Pi 4 Power Supply (US Plug) with Noise Filter, Set of Heat Sinks, Display Cable - 6 foot (Supports up to 4K60p)
  • CanaKit USB-C PiSwitch (On/Off Power Switch for Raspberry Pi 4)
services:
  urlwatch:
    image: ghcr.io/mjaschen/urlwatch
    volumes:
      - ./data:/data/urlwatch

The image reference above is the floating reference used in the project’s examples; the cited README does not establish an immutable tag or digest. If you need repeatable deployments, choose and verify an image version or digest using the project’s current image-publishing information rather than assuming this reference is pinned.

Start, inspect, and stop the service

  1. Start the service in the background from the directory with compose.yaml:

    docker compose up -d
  2. Follow its output to confirm it is running and to diagnose job, configuration, or reporter issues:

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
    docker compose logs -f
  3. Stop the Compose service when needed:

    docker compose down

Stopping or recreating the container does not remove the host-side data/ directory. Keep that directory in place when updating or replacing the container; it is the persistence boundary.

Use Docker directly instead

Compose is convenient for managing a project service with up, logs, and down. For a one-time interactive run or a single background container, the project also documents direct docker run commands. Both approaches mount the same host data folder at /data/urlwatch.

Rank #3
ELECROW CrowPi Case Kit for Raspberry Pi 5, 9-Inch Display
  • Not including the Raspberry Pi 5 (8GB), the Crowpi advanced version comes with the Raspberry Pi 5
  • ELECROW Black Case for the Raspberry Pi 5, CrowPi is equipped with a 9-inch HD touchscreen along with a camera; All the regular components used in DIY electronics are packed into the CrowPi development board, such as LCD, LED matrix, buzzer, light sensor, PIR sensor, ultrasonic sensor, IR sensor, etc
  • Raspberry Pi Sensors: The Crowpi raspberry pi 5 programming kit is jam-packed with lots of buttons such as 19 different sensors in a tidy easy to use package; You don't have to wait and wire things
  • Build Quality: Solid ABS shell and well made components in one place make it strong and convenient to travel
  • Programming Lessons: This raspberry pi 5 learning kit ships with step by step instructions and provides 21 lessons to take you through identifying components reading code and running it in the terminal

One-time interactive run

docker run --rm --interactive --tty 
  --volume "$(pwd)/data":/data/urlwatch 
  --volume /etc/localtime:/etc/localtime:ro 
  ghcr.io/mjaschen/urlwatch

Run in the background

docker run --detach 
  --restart unless-stopped 
  --name urlwatch 
  --volume "$(pwd)/data":/data/urlwatch 
  --volume /etc/localtime:/etc/localtime:ro 
  ghcr.io/mjaschen/urlwatch

Follow the background container’s output with:

docker logs --follow urlwatch

These examples include a read-only mount of /etc/localtime from the host. The host-side data path is based on running the command from the directory containing data/; adjust the host path if you run it elsewhere, but keep the container destination at /data/urlwatch for this image.

Understand and change the checking schedule

The mjaschen/urlwatch-docker README says its image runs every 15 minutes by default. This is the default schedule documented for that image, not a guarantee for every urlwatch container or community image.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For an hourly schedule, the README gives this cron entry:

0 * * * * cd /data/urlwatch && urlwatch --verbose --urls urls.yaml --config urlwatch.yaml --hooks hooks.py --cache cache.db

To use that schedule, the modified crontab must be mounted into the container. Preserve the working-directory paths and filenames used in the command. The README’s example explicitly supplies all four working-file options; do not move the data mount to a different container path without also changing the command to match the image and your configuration.

Troubleshoot common problems

  • Jobs or settings seem to reset after a container replacement: check that the host directory is mounted at /data/urlwatch and that you are editing files in the host-side directory actually used by Compose or docker run. Preserve that directory when updating the container.

    Rank #4
    CanaKit Raspberry Pi 5 Desktop PC with SSD (Fully Assembled) (256 GB SSD)
    • Fully assembled for plug-and-play operation
    • Includes Raspberry Pi 5 with 8GB RAM
    • 256 GB PCIe Pi NVMe SSD (Pre-loaded with Pi 64-Bit OS)
    • M.2 HAT+
    • CanaKit Turbine Black Case for the Pi 5
  • No jobs run or the job list is empty: confirm that the file is named urls.yaml and is inside the mounted host data directory. Check the YAML and job syntax against the urlwatch version in the image.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Notifications are missing: verify that urlwatch.yaml was created from the template, that a reporter is configured under report, and that its credentials and settings are valid. Inspect the container logs for configuration or delivery errors.

  • A schedule change has no effect: the hourly example requires the modified crontab to be mounted into the container. Also verify that the command uses the mounted working directory and the intended file names.

  • Commands or settings behave differently from documentation: the configuration manual cited here is for urlwatch 2.29, and the image example uses a floating image reference. Confirm the version actually included in your image, then use matching documentation and options.

  • A Compose example from another image uses a different path: do not mix paths between container images. This project’s examples use /data/urlwatch; other images may use a different location.

    What’s actually slowing this PC down?

    Pick the symptom - the matching free tool is one click away.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
    Best Value
    RasTech Raspberry Pi 5 8GB Kit with Active Cooler and Pi5 Case
    • 【What you Get】You will get 1*Pi 5 8GB Single Board,1*RasTech Case,1*Active Cooler,1*Screwdriver,1*Installation instructions,12-month free warranty, lifetime service, 24-hour prompt and friendly response.
    • 【More Connectors】There are two USB 3.0 ports(5Gbps simultaneously) and two USB 2.0 ports, which triple total bandwidth ,support any combination of up to two cameras or displays. Peak SD card performance is doubled through support for the SDR104 high-speed mode. It provides a smooth desktop experience for you. Offer Gigabit Ethernet and a PCIe interface, along with dual-band Wi-Fi and Bluetooth 5.0/BLE wireless capability. The RasTech Pi 5 Kit use the new 27W 5.1V 5A USB-C power connector.
    • 【 Support Dual 4Kp60 Display 】Each of the two microHDMI sockets can control a 4K display at 60 Hertz, now support HDR, offering super HD video for media streaming projects. RPi 5 is the first RPi model that comes with a PCI Express port (PCIe 2.0 x1 with 500 MB/s) to attach SSDs (requires separate M.2 HAT).
    • 【 Excellent Chips And Applications】Pi 5 is a full-size Pi computer using silicon built in-house at Pi. The RP1 “southbridge” provides the bulk of the I/O capabilities for Pi 5. Pi 5 is more friendly and convenient in the development of Internet of Things, Web development, machine identification, automatic control and other electronic equipment applications and network.
    • 【 Faster CPU, Better GPU 】 Pi 5 features a Broadcom BCM2712 64-bit quad-core Arm Cortex-A76 processor running at 2.4GHz, it delivers a 2–3× increase in CPU performance relative to RaspberryPi 4. The 800MHz VideoCore VII GPU is compatible to OpenGL ES 3.1 and Vulkan 1.2, substantial uplift in graphics performance. Pi 5 Offers lightning-fast CPU speed, a PCI Express interface, a Real Time Clock (RTC) and a power button and runs significantly cooler than Pi 4.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

Urlwatch checks for changes and can notify you; ScreenshotNeo solves a different problem: capturing a web page as an image or PDF. It is not a substitute for scheduled change monitoring, but it can be useful when you need a clean screenshot instead of configuring a browser capture yourself. Its API accepts a URL in one GET request. See the ScreenshotNeo API documentation.

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Sign up for ScreenshotNeo free to get 1,000 screenshots a month with no card.

Quick Recap

Bestseller No. 1
CanaKit Raspberry Pi 5 Starter Kit PRO - Turbine Black (128GB Edition) (8GB RAM)
CanaKit Raspberry Pi 5 Starter Kit PRO - Turbine Black (128GB Edition) (8GB RAM)
Includes Raspberry Pi 5 with 2.4Ghz 64-bit quad-core CPU (8GB RAM); CanaKit Turbine Black Case for the Raspberry Pi 5
$259.95
Bestseller No. 2
CanaKit Raspberry Pi 4 4GB Starter PRO Kit - 4GB RAM
CanaKit Raspberry Pi 4 4GB Starter PRO Kit - 4GB RAM
Includes Raspberry Pi 4 4GB Model B with 1.5GHz 64-bit quad-core CPU (4GB RAM); Includes Pre-Loaded 32GB EVO+ Micro SD Card (Class 10), USB MicroSD Card Reader
$159.99
Bestseller No. 4
CanaKit Raspberry Pi 5 Desktop PC with SSD (Fully Assembled) (256 GB SSD)
CanaKit Raspberry Pi 5 Desktop PC with SSD (Fully Assembled) (256 GB SSD)
Fully assembled for plug-and-play operation; Includes Raspberry Pi 5 with 8GB RAM; 256 GB PCIe Pi NVMe SSD (Pre-loaded with Pi 64-Bit OS)
$339.97

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.