immich onboarding

Run the payout watcher beside your Immich server.

Immich does not expose a payment plugin surface. Tollgate's Immich path is a co-located sidecar: it watches your nginx access log for shared-link archive downloads, resolves the assets through Immich's API, and pays registered owners.

runtimeDocker sidecar

inputnginx access log

registryowner ID to wallet

immich owner setup

Map an owner to a wallet

docker sidecar

Build and run beside Immich

build image

git clone https://github.com/Ridwannurudeen/tollgate.git
cd tollgate
docker build -f aperture/Dockerfile -t tollgate-immich-sidecar ./aperture

aperture.env

APERTURE_ACCESS_LOG=/var/log/nginx/access.log
APERTURE_IMMICH_API_BASE_URL=http://127.0.0.1:2283/api
APERTURE_LICENSE_FEE_ATOMIC_USDC=2500
APERTURE_FEE_ROUTER_ENABLED=1
APERTURE_FEE_ROUTER_PRIVATE_KEY=<operator-private-key>

run watcher

docker volume create tollgate-aperture-data
docker run -d --name tollgate-immich-sidecar --restart unless-stopped --network host --env-file ./aperture.env -v /var/log/nginx/access.log:/var/log/nginx/access.log:ro -v tollgate-aperture-data:/app/data tollgate-immich-sidecar

owner mapping

Approve a creator wallet locally

The command below writes an operator-approved mapping into the same `/app/data` volume used by the watcher container.

docker run --rm --network host --env-file ./aperture.env -v tollgate-aperture-data:/app/data tollgate-immich-sidecar npm run register:owner -- --owner-id 'immich-owner-uuid' --display-name 'Jane Lens' --wallet '0x...'

hosted proof registry

Public Tollgate mapping form

The form on this page writes to Tollgate's hosted Aperture registry. For your own Immich deployment, use the Docker volume and `register:owner` command above so the mapping lives beside your watcher.

View Aperture proof feed

boundary

Not remotely hosted

WordPress and Jellyfin can call hosted Tollgate APIs. Immich download detection depends on the operator's nginx log, so the sidecar must run on the same host or log volume as Immich.

Open Immich proof dashboard