Docker container for sd-webui-infinite-image-browsing standalone mode.

docker run -d \
  -p 8080:8080 \
  -v /path/to/your/images:/outputs:ro \
  -v iib-cache:/cache \
  ghcr.io/pbanddev/infinite-image-browser-docker:latest

Open http://localhost:8080

latest is built from upstream main, and the frontend assets are rebuilt from that checkout before the image is published.

vX.Y.Z is built from the matching upstream tag, and the frontend assets are rebuilt from that tagged checkout before the image is published.

Use a version tag for stability:

docker pull ghcr.io/pbanddev/infinite-image-browser-docker:v1.2.3

This repo does not trust upstream checked-in vue/dist assets for release metadata. The Docker build rebuilds the frontend from the authoritative upstream source checkout so the served UI version stays aligned with the checked-out commit or tag.

If the image date and the app version look different, check the running container directly:

docker exec infinite-image-browser sh -lc 'curl -fsS http://127.0.0.1:8080/infinite_image_browsing/version'

hash and tag are the source of truth for the running app, not the image build date.

Use the root compose file to run the published GHCR image:

services:
  iib:
    image: ghcr.io/pbanddev/infinite-image-browser-docker:latest
    ports:
      - "8080:8080"
    volumes:
      - /path/to/images:/outputs:ro
      - iib-cache:/cache
    restart: unless-stopped

volumes:
  iib-cache:

Start it with:

docker compose up -d

All environment variables are passed through to IIB. Docker sets sensible defaults for containerized usage.

For full list, see IIB's .env.example.

docker run -d \
  -p 8080:8080 \
  -v /path/to/images:/outputs:ro \
  -v /path/to/data:/data \
  -e IIB_DB_PATH=/data/iib.db \
  -e IIB_CACHE_DIR=/data/cache \
  ghcr.io/pbanddev/infinite-image-browser-docker:latest

The container includes a default favicon. To use your own custom favicon, mount an SVG file to /app/custom/favicon.svg:

docker run -d \
  -p 8080:8080 \
  -v /path/to/images:/outputs:ro \
  -v iib-cache:/cache \
  -v /path/to/my-favicon.svg:/app/custom/favicon.svg:ro \
  ghcr.io/pbanddev/infinite-image-browser-docker:latest

services:
  iib:
    image: ghcr.io/pbanddev/infinite-image-browser-docker:latest
    ports:
      - "8080:8080"
    volumes:
      - /path/to/images:/outputs:ro
      - iib-cache:/cache
      - ./my-favicon.svg:/app/custom/favicon.svg:ro
    restart: unless-stopped

volumes:
  iib-cache:

If you have an existing IIB database with likes/tags:

1. Copy your iib.db to a mounted volume
2. Set IIB_DB_PATH to point to it
3. Run path migration (Windows paths → container paths):

   docker exec <container> python migrate.py \
     --db_path /data/iib.db \
     --old_dir "C:\Your\Local\Output\Path" \
     --new_dir "/outputs"

git clone https://github.com/PBandDev/infinite-image-browser-docker
cd infinite-image-browser-docker
docker compose -f compose.dev.yaml up --build

Check that the runtime metadata, source tree, and embedded frontend assets stay in sync:

The shell verifier expects docker, curl, and python3 or python on the host.

./scripts/runtime/verify-image.sh ghcr.io/pbanddev/infinite-image-browser-docker:latest

.\scripts\windows\verify-image.ps1 -ImageRef ghcr.io/pbanddev/infinite-image-browser-docker:latest

AGPL-3.0