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:
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.yamland every upload path must be a path as the container sees it: a file at/home/user/media/movies/Movie.2023mounted via- /home/user/media:/datais/data/movies/Movie.2023. - Reaching services on the host (qBittorrent, Radarr, Sonarr, cross-seed): use
host.docker.internalinstead oflocalhost, e.g.qbittorrent.host: "http://host.docker.internal:8080". On Linux with older Docker versions, additionally add:
- Additional mounts for your libraries as needed, read-only where possible:
- 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:
Updating¶
The binary's auto-update feature is disabled in Docker — update by pulling a new image:
For automatic image updates, use a tool like Watchtower.
Troubleshooting¶
- Container won't start —
docker compose logs; usual causes are a missing or invalidconfig.yaml, a port already in use, or volume permissions. - Can't reach qBittorrent/Radarr/Sonarr — use
host.docker.internal(see above), notlocalhost. - 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 atconfigs/config.yamlon the host, mounted to/home/uppollo/.config/upPollo.Failed to migrate config file: ... device or resource busy—config.yamlis mounted as a single file. Config migration replaces the file, which Docker does not allow for a single-file mount. Mount theconfigsdirectory 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 matchapi.port, and the container must be running (docker compose ps,docker compose logs -f). - Shell inside the container —
docker compose exec uppollo sh.