Files
wizarr/docs/getting-started/installation.md
2025-08-16 09:14:32 +00:00

3.9 KiB

Installation

Installation

Docker

{% hint style="warning" %} Be sure to replace/path/to/appdata/config in the below examples with a valid host directory path. If this volume mount is not configured correctly, your Wizarr settings/data will not be persisted when the container is recreated (e.g., when updating the image or rebooting your machine).

The TZ environment variable value should also be set to the TZ database name of your time zone! {% endhint %}

{% tabs %} {% tab title="Docker Compose (recommended)" %} Installation:

Define the wizarr service in your docker-compose.yml as follows:

---
services:
  wizarr:
    container_name: wizarr
    image: ghcr.io/wizarrrr/wizarr
    ports:
      - 5690:5690
    volumes:
      - /path/to/appdata:/data
    environment:
      - PUID=1000 #Set UID
      - PGID=1000 #Set GID
      - DISABLE_BUILTIN_AUTH=false #Set to true ONLY if you are using another auth provider (Authelia, Authentik, etc)
      - TZ=Europe/London #Set your timezone here

Then, start all services defined in the Compose file:

docker compose up -d or docker-compose up -d

Updating

Pull the latest image:

docker compose pull wizarr or docker-compose pull wizarr

Then, restart all services defined in the Compose file:

docker compose up -d or docker-compose up -d {% endtab %}

{% tab title="Docker CLI" %} Installation

docker run -d \
  --name wizarr \
  -e DISABLE_BUILTIN_AUTH=false \
  -e PUID=1000 -e PGID=1000 \
  -e TZ=Europe/London \
  -p 5690:5690 \
  -v /path/to/appdata:/data \
  --restart unless-stopped \
  ghcr.io/wizarrrr/wizarr

Updating

Stop and remove the existing container:

docker stop wizarr && docker rm wizarr

Pull the latest image:

docker pull ghcr.io/wizarrrr/wizarr

Finally, run the container with the same parameters originally used to create the container:

docker run -d ...

{% endtab %} {% endtabs %}

Unraid

  1. Ensure you have the Community Applications plugin installed.
  2. Inside the Community Applications app store, search for Wizarr.
  3. Click the Install Button.
  4. On the following Add Container screen, make changes to the Host Port and Host Path 1(Appdata) as needed, as well as the environment variables.
  5. Click apply and access "Wizarr" at your <ServerIP:HostPort> in a web browser.

TrueNas Fangtooth

  1. Discover Apps

    image

  2. Custom App

    image

  3. Quick install if you know what your doing.

    image

All other steps below are every single thing that needs to be changed. Also only things that need to be setup.

  1. Use only what is used in pictures following. Don't change anything unless you know what your doing. For storage locations make changes to match your setup.

Repository: ghcr.io/wizarrrr/wizarr

image

image

image

image

image

image

image

  1. Click Install

    image