Instalación¶

Dispatcharr puede instalarse en varias plataformas a través del uso de Docker, incluyendo Windows, macOS, Proxmox y Unraid. Esta guía proporciona instrucciones detalladas para cada método.

Requisitos¶

Asegúrate de que Docker y Docker Compose estén instalados en tu plataforma.

Docker Compose¶

Dispatcharr es distribuido utilizando el siguiente docker-compose.yml:

services:
  dispatcharr:
    # build:
    #   context: .
    #   dockerfile: Dockerfile
    image: ghcr.io/dispatcharr/dispatcharr:latest
    container_name: dispatcharr
    ports:
      - 9191:9191
    volumes:
      - dispatcharr_data:/data
    environment:
      - DISPATCHARR_ENV=aio
      - REDIS_HOST=localhost
      - CELERY_BROKER_URL=redis://localhost:6379/0
      - DISPATCHARR_LOG_LEVEL=info
      # Process Priority Configuration (Optional)
      # Lower values = higher priority. Range: -20 (highest) to 19 (lowest)
      # Negative values require cap_add: SYS_NICE (uncomment below)
      #- UWSGI_NICE_LEVEL=-5   # uWSGI/FFmpeg/Streaming (default: 0, recommended: -5 for high priority)
      #- CELERY_NICE_LEVEL=5   # Celery/EPG/Background tasks (default: 5, low priority)
    #
    # Uncomment to enable high priority for streaming (required if UWSGI_NICE_LEVEL < 0)
    #cap_add:
    #  - SYS_NICE
    # Optional for hardware acceleration
    #devices:
    #  - /dev/dri:/dev/dri  # For Intel/AMD GPU acceleration (VA-API)
    # Uncomment the following lines for NVIDIA GPU support
    # NVidia GPU support (requires NVIDIA Container Toolkit)
    #deploy:
    #  resources:
    #      reservations:
    #          devices:
    #              - driver: nvidia
    #                count: all
    #                capabilities: [gpu]


volumes:
  dispatcharr_data:

Pasos de Instalación¶

Windows Docker¶

Instala y ejecuta Docker para Escritorio (Desktop).
Crea un directorio, por ejemplo: C:\Dispatcharr, y dentro del directorio crea un archivo con el nombre docker-compose.yml con el contenido proporcionado.
Abre una consola/ventana de PowerShell o de Comandos (CMD) en el directario creado.
Inicia Dispatcharr con:
```
docker compose up -d
```

macOS Docker¶

Instala e inicia Docker para Escritorio (Desktop)
Crea un directorio para Dispatcharr, por ejemplo: ~/Dispatcharr.
Crea un archivo con el nombredocker-compose.yml y el contenido proporcionado.
Ejecuta una Terminal y navega al directorio creado:
```
cd ~/Dispatcharr
```
Ejecuta del Contenedor (Container):
```
docker compose up -d
```

Linux Docker¶

Advertencia

Algunas distribuciones utilizan versiones desactualizadas de Docker, por lo que se recomienda instalarlo directamente desde Docker.

Instala Docker siguiendo las instrucciones oficiales, como las disponibles para Ubuntu

Ejemplo Ubuntu

Desinstala versiones desactualizadas.

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

Configura el repositorio apt oficial de Docker para asegurarte de instalar la versión más reciente.

# Agrega la clave GPG oficial de Docker:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Agrega el repositorio a las fuentes de Apt.:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Instala Docker.

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Crea y navega hacia tu directorio de Dispatcharr.
```
mkdir ~/dispatcharr && cd ~/dispatcharr
```
Agrega tu propio docker-compose.yml o utiliza el ejemplo proporcionado.
Inicia Dispatcharr:
```
docker compose up -d
```

Nota

Si deseas utilizar los comandos de docker compose sin sudo, es recomendable que sigas la guia oficial de Docker aquí.

Proxmox¶

Crea un contenedor LXC o VM con Docker y Docker Compose instalados.
```
apt install docker.io docker-compose -y
```
Crea y navega hacia tu directorio de Dispatcharr:
```
mkdir ~/dispatcharr && cd ~/dispatcharr
```
Agrega tu archivo docker-compose.yml.
Inicia Dispatcharr:
```
docker compose up -d
```

Unraid¶

Ve a la pestaña “Apps” en tu servidor Unraid.
Busca “Dispatcharr” y selecciona "Install".
Mantén los valores predeterminados, a menos que necesites modificarlos.

Compilación desde el código fuente (No Soportado)¶

Clona este repositorio:

git clone https://github.com/Dispatcharr/Dispatcharr.git
cd Dispatcharr

Crea y activa un entorno virtual (opcional pero recomendado):
```
python -m venv venv
source venv/bin/activate
```
Instala las dependencias requeridas:
```
pip install -r requirements.txt
```
Ejecuta la migración de la base de datos e inicia el servidor (Django + front-end React):
```
python manage.py migrate
python manage.py runserver
```
Para el front-end, navega al directorio frontend/ y ejecuta:
```
npm install
npm run build
```
Una vez en ejecución, visita, http://localhost:9191 (o el puerto que hayas configurado) en tu navegador.

Acceso a Dispatcharr¶

Abre tu navegador y navega a:

http://localhost:9191

Si estas accediendo de forma remota, reemplaza localhost por la direccion IP de tu servidor.