Skip to content

Docker

upPollo ships as a Docker image whose default command is upPollo serve — a running container is an API mode server. CLI commands are run inside the same container with docker compose exec.

The image contains ffmpeg and MediaInfo. MediaInfo is built from a pinned upstream release, so it can be newer than the package of your Linux distribution; docker compose exec uppollo mediainfo --Version shows the version.

Quick start

mkdir -p uppollo/{data,configs,logs} && cd uppollo
curl -o docker-compose.yml https://codeberg.org/upPollo/upPollo/raw/branch/stable/docker-compose.yml

Create configs/config.yaml (start from the example config) with at least api.port: 9999, your tracker and torrent client settings, tmdb_api_key, tvdb_api_key, and one enabled screenshot host. Where to get the keys is described in Getting started: First configuration. Then:

docker compose up -d
docker compose logs -f

The bundled compose file:

services:
    uppollo:
        image: uppollo/uppollo:latest
        container_name: uppollo
        ports:
            - "9999:9999"
        volumes:
            - ./data:/data                             # media to upload
            - ./configs:/home/uppollo/.config/upPollo  # config directory
            - ./logs:/var/log/uppollo                  # log directory
        restart: unless-stopped

Set logging.directory: "/var/log/uppollo" in your config so logs land in the mounted ./logs directory.

Image tags

Tag Description
latest Newest stable release — recommended
nightly Nightly build from main; new features first, may be unstable
v1.14.2 A specific release, for pinning
stable Alias for latest, kept for compose files that already use it

Configuration notes

  • Container paths, not host paths. Everything in config.yaml and every upload path must be a path as the container sees it: a file at /home/user/media/movies/Movie.2023 mounted via - /home/user/media:/data is /data/movies/Movie.2023.
  • Reaching services on the host (qBittorrent, Radarr, Sonarr, cross-seed): use host.docker.internal instead of localhost, e.g. qbittorrent.host: "http://host.docker.internal:8080". On Linux with older Docker versions, additionally add:
extra_hosts:
    - "host.docker.internal:host-gateway"
  • Additional mounts for your libraries as needed, read-only where possible:
volumes:
    - /mnt/media/movies:/media/movies:ro
    - /mnt/media/tv:/media/tv:ro
  • To join other containers' network, attach the service to your existing Docker network with a networks: block.

Running CLI commands

The container already runs the API server; execute CLI commands alongside it:

docker compose exec -it uppollo upPollo upload --unattended /data/movies/Movie.Title.2023
docker compose exec uppollo upPollo version
docker compose exec uppollo upPollo config validate

Interactive prompts need the -it flags — or use --unattended. For a one-off command without the API server, override the entrypoint:

docker compose run --rm --entrypoint /usr/local/bin/upPollo uppollo upload /data/movies/Movie.2023

Updating

The binary's auto-update feature is disabled in Docker — update by pulling a new image:

docker compose pull
docker compose up -d
docker image prune -f

For automatic image updates, use a tool like Watchtower.

Troubleshooting

  • Container won't start — docker compose logs; usual causes are a missing or invalid config.yaml, a port already in use, or volume permissions.
  • Can't reach qBittorrent/Radarr/Sonarr — use host.docker.internal (see above), not localhost.
  • Permission denied on volumes — the container runs as UID 1000: sudo chown -R 1000:1000 data configs logs.
  • Error loading config — the config must be at configs/config.yaml on the host, mounted to /home/uppollo/.config/upPollo.
  • Failed to migrate config file: ... device or resource busy — config.yaml is mounted as a single file. Config migration replaces the file, which Docker does not allow for a single-file mount. Mount the configs directory as in the compose file above.
  • Media files not found — you passed a host path; use the container path (see Configuration notes).
  • API not reachable — port mapping (9999:9999) must match api.port, and the container must be running (docker compose ps, docker compose logs -f).
  • Shell inside the container — docker compose exec uppollo sh.