Skip to main content

Installation via Docker

Supported Architectures

The Unmanic docker image is built for the following architectures:

note

It may work on others such as Windows or MacOS but they will not be officially supported at this time.

Follow the community provided Windows 10 installation guide if you wish to attempt installing and running Unmanic on Windows 10 or 11.

  • linux/amd64
  • linux/armv7
  • linux/arm64

Running Unmanic

There are a number of ways you may start Unmanic with Docker.

The most basic method is shown below:

  PUID=$(id -u)
PGID=$(id -g)

# CONFIG_DIR - Where you settings are saved
CONFIG_DIR=/config

# LIBRARY_DIR - The location/locations of your library
LIBRARY_DIR=/library

# CACHE_DIR - A tmpfs or and folder for temporary conversion files
CACHE_DIR=/tmp/unmanic

docker run -ti --rm \
-e PUID=${PUID} \
-e PGID=${PGID} \
-p 8888:8888 \
-v ${CONFIG_DIR}:/config \
-v ${LIBRARY_DIR}:/library \
-v ${CACHE_DIR}:/tmp/unmanic \
josh5/unmanic:latest

For more advanced methods using hardware acceleration, see these articles: