Application Setup

Read-Only Operation

Non-Root Operation

Usage

docker-compose (recommended, click here for more info)

---
services:
  changedetection:
    image: lscr.io/linuxserver/changedetection.io:latest
    container_name: changedetection
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - BASE_URL= #optional
      - PLAYWRIGHT_DRIVER_URL= #optional
    volumes:
      - /path/to/changedetection/config:/config
    ports:
      - 5000:5000
    restart: unless-stopped

docker cli (click here for more info)

docker run -d \
  --name=changedetection.io \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e BASE_URL= `#optional` \
  -e PLAYWRIGHT_DRIVER_URL= `#optional` \
  -p 5000:5000 \
  -v /path/to/changedetection.io/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/changedetection.io:latest

Parameters

Environment variables from files (Docker secrets)

-e FILE__MYVAR=/run/secrets/mysecretvariable

Umask for running applications

User / Group Identifiers

id your_user

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

Support Info

• Shell access whilst the container is running:

```bash
docker exec -it changedetection.io /bin/bash
```

• To monitor the logs of the container in realtime:

```bash
docker logs -f changedetection.io
```

• Container version number:

```bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' changedetection.io
```

• Image version number:

```bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/changedetection.io:latest
```

Updating Info

Via Docker Compose

• Update images:

* All images:

    ```bash
    docker-compose pull
    ```

* Single image:

    ```bash
    docker-compose pull changedetection.io
    ```

• Update containers:

* All containers:

    ```bash
    docker-compose up -d
    ```

* Single container:

    ```bash
    docker-compose up -d changedetection.io
    ```

• You can also remove the old dangling images:

```bash
docker image prune
```

Via Docker Run

• Update the image:

```bash
docker pull lscr.io/linuxserver/changedetection.io:latest
```

• Stop the running container:

```bash
docker stop changedetection.io
```

• Delete the container:

```bash
docker rm changedetection.io
```

• Recreate a new container with the same docker run parameters as instructed above (if mapped correctly to a host folder, your /config folder and settings will be preserved)
• You can also remove the old dangling images:

```bash
docker image prune
```

Image Update Notifications - Diun (Docker Image Update Notifier)

Building locally

git clone https://github.com/linuxserver/docker-changedetection.io.git
cd docker-changedetection.io
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/changedetection.io:latest .

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset