ion606/immich-webhook-poller repository overview

⁠Immich Monitor

A simple bash program to poll your immich install and send any new file IDs/types to predefined webhooks

⁠Repo Link!

https://github.com/ION606/immich-webhook-poller⁠

⁠Configuration

You need "two" files to run this program (one if you directly inject the envars into the env). The first file should be .env and be structured like:

IMMICH_BASE_URL=https://myimmichinstance.com
IMMICH_API_KEY=eggnogisgood212121

The second file is hooks.json and should contain the webhook URLs and their corresponding API keys in the following format:

[
	{
		"url": "http://example.com",
		"key": "thisisakey"
	}
]

⁠Running the Program

My recommendation is to use either docker or docker compose. If you choose to use docker you can simply run it as

docker run \
	--env-file .env \
	-v /path/to/hooks.json:/hooks.json \
	-v immich_hooks_data:/store.txt \
	ion606:immich-webhook-poller

(Make sure to create the volume first)

If you want to use compose, create a service with

services:
  immich-poller:
    image: ion606/immich-webhook-poller:latest
    env_file: .env

    # if you want persistance
    volumes:
      - immich_hooks_data:/hooks

# if you want persistance
volumes:
  immich_hooks_data: