Unraid: Sistema Operativo NAS para Homelab (Guía Completa 2025)

📋 TL;DR (Resumen Ejecutivo)

Unraid es un sistema operativo Linux especializado para Network-Attached Storage (NAS) que permite usar discos de diferentes tamaños sin configuraciones RAID complejas. A diferencia de TrueNAS Scale o Proxmox, Unraid destaca por su simplicidad y facilidad de uso, ideal para homelabs que buscan un NAS potente con Docker-2025/) y VMs integrados sin la complejidad de sistemas enterprise.

En esta guía completa aprenderás a instalar, configurar y optimizar Unraid desde cero, incluyendo configuración de almacenamiento flexible, gestión de Docker con Community Applications, creación de máquinas virtuales con GPU passthrough, y mejores prácticas de seguridad y backup.

Lo que conseguirás:

• ✅ Un NAS flexible que acepta discos de diferentes tamaños
• ✅ Docker extremadamente fácil con más de 2,000 aplicaciones preconfiguradas
• ✅ Soporte para VMs con GPU passthrough para gaming o workloads intensivos
• ✅ Interfaz web intuitiva que simplifica toda la gestión

Tiempo de lectura: ~25 minutos | Nivel: Intermedio

—

📚 Tabla de Contenidos

1. ¿Qué es Unraid y Por Qué Usarlo?
2. Unraid vs TrueNAS Scale vs Proxmox: Comparativa Completa
3. Requisitos de Hardware
4. Instalación Paso a Paso
5. Configuración de Almacenamiento
6. Docker en Unraid: Community Applications
7. Máquinas Virtuales (VMs) y GPU Passthrough
8. Plugins y Extensiones Esenciales
9. Backup y Seguridad
10. Troubleshooting: Errores Comunes
11. Mejores Prácticas y Optimización
12. Preguntas Frecuentes
13. Recursos y Ejemplos Descargables

—

> 📅 Última actualización: Diciembre 2025

> ✅ Verificado con: Unraid OS 6.12+

> 🔄 Próxima revisión: Marzo 2026

—

Introducción

¿Cansado de sistemas NAS complejos que requieren discos del mismo tamaño y configuraciones RAID complicadas? ¿Quieres un sistema que combine almacenamiento flexible, Docker fácil y virtualización, todo desde una interfaz web intuitiva? Unraid es la solución perfecta para homelabs que buscan simplicidad sin sacrificar funcionalidad.

Problema que resuelve:

Los sistemas NAS tradicionales como TrueNAS requieren discos uniformes y configuraciones RAID complejas. Si tienes discos acumulados de diferentes tamaños a lo largo del tiempo, terminas desperdiciando espacio o enfrentándote a configuraciones complicadas. Además, gestionar Docker y VMs en sistemas enterprise puede ser abrumador para usuarios de homelab.

La solución:

Unraid es un sistema operativo Linux especializado para NAS que permite usar discos de diferentes tamaños sin desperdiciar espacio. A diferencia de TrueNAS Scale o Proxmox, Unraid destaca por su interfaz web extremadamente intuitiva, Docker integrado con Community Applications (más de 2,000 apps preconfiguradas), y soporte para VMs con GPU passthrough, todo sin la complejidad de sistemas enterprise.

En esta guía completa aprenderás:

• Cómo instalar Unraid desde cero en tu homelab
• Configurar almacenamiento flexible con discos de diferentes tamaños
• Instalar y gestionar Docker con Community Applications
• Crear máquinas virtuales con GPU passthrough
• Optimizar rendimiento con cache pools y shares
• Implementar backups y medidas de seguridad
• Solucionar problemas comunes y errores frecuentes

Ya seas un usuario de homelab principiante buscando simplicidad, un usuario avanzado que quiere flexibilidad de almacenamiento, o alguien que necesita Docker y VMs integrados, esta guía te dará todo lo necesario para montar y gestionar tu NAS con Unraid.

—

¿Qué es Unraid?

Definición y Características Principales

Unraid es un sistema operativo Linux especializado para Network-Attached Storage (NAS) diseñado específicamente para homelabs y pequeñas oficinas. A diferencia de los sistemas RAID tradicionales que requieren discos del mismo tamaño y configuraciones complejas, Unraid permite usar discos de diferentes capacidades sin desperdiciar espacio.

Características principales:

• ✅ Flexibilidad de almacenamiento: Puedes mezclar discos de 4TB, 6TB, 8TB, etc. sin problemas. Solo el disco de paridad debe ser igual o mayor que el disco de datos más grande.

• ✅ Protección de datos: Sistema de paridad (single o dual) que protege contra fallos de disco. Si un disco falla, solo pierdes los datos de ese disco específico, no todo el array.

• ✅ Docker integrado: Soporte nativo para contenedores Docker con Community Applications, un catálogo de más de 2,000 aplicaciones preconfiguradas (Plex, Nextcloud, Home Assistant-automatiza-tu-casa-con-ia-local-guia-completa-2025/), etc.).

• ✅ Virtualización: Soporte para máquinas virtuales (VMs) con KVM, incluyendo GPU passthrough para gaming o workloads intensivos.

• ✅ Interfaz web intuitiva: Gestión completa desde navegador web. No necesitas conocimientos avanzados de Linux para configurar y gestionar tu NAS.

• ✅ Expansión incremental: Añade discos cuando los necesites sin reconstruir el array. Simplemente apagas, añades el disco, y lo asignas al array.

• ✅ Cache pools: Discos SSD/NVMe de alta velocidad para mejorar el rendimiento de escritura. El «Mover» transfiere datos del cache al array automáticamente.

Sistema de Licencias

Unraid opera con un modelo de licencias de pago (no es open source como TrueNAS o Proxmox):

Nota: Los dispositivos incluyen discos de datos, paridad y cache. Por ejemplo, con Basic (6 dispositivos) puedes tener: 1 parity + 1 cache + 4 data drives.

Las licencias incluyen actualizaciones durante el período de validez (1 año para licencias temporales, ilimitadas para lifetime licenses).

¿Por Qué Usar Unraid?

Casos de uso ideales:

1. Homelabs con discos acumulados: Si tienes discos de diferentes tamaños acumulados a lo largo del tiempo, Unraid es perfecto. No necesitas comprar discos nuevos del mismo tamaño.

1. Usuarios que buscan simplicidad: Si TrueNAS Scale te parece complejo o Proxmox está orientado a virtualización avanzada, Unraid ofrece una interfaz más intuitiva.

1. Docker fácil: Community Applications hace que instalar aplicaciones Docker sea tan fácil como instalar una app en tu teléfono. Más de 2,000 aplicaciones preconfiguradas.

1. Gaming o workloads intensivos: El soporte para GPU passthrough permite crear VMs Windows para gaming o workloads que requieren GPU dedicada.

NO uses Unraid si:

• ❌ Necesitas clustering o High Availability (HA) – Unraid no soporta clustering
• ❌ Priorizas integridad de datos sobre simplicidad – ZFS en TrueNAS ofrece auto-healing y snapshots avanzados
• ❌ Necesitas virtualización enterprise – Proxmox es superior para clustering, live migration, etc.
• ❌ Prefieres software completamente gratuito – Unraid requiere licencia (TrueNAS y Proxmox son gratis)

—

Unraid vs TrueNAS Scale vs Proxmox: Comparativa Completa

Elegir entre Unraid, TrueNAS Scale y Proxmox depende de tus necesidades específicas. Esta comparativa te ayudará a decidir cuál es mejor para tu homelab.

Almacenamiento y Flexibilidad

Ventaja Unraid: Flexibilidad máxima para homelabs con discos de diferentes tamaños acumulados a lo largo del tiempo. Puedes añadir un disco de 8TB cuando encuentres una buena oferta, sin preocuparte por tener que comprar más discos del mismo tamaño.

Ventaja TrueNAS/Proxmox: ZFS ofrece integridad de datos superior con auto-healing, snapshots avanzados, y mejor rendimiento en configuraciones RAID.

Virtualización y Contenedores

Ventaja Unraid: Docker extremadamente fácil con Community Applications. Instalar Plex, Nextcloud, Home Assistant, etc. es tan simple como buscar e instalar desde la UI. No necesitas conocimientos de Kubernetes o YAML.

Ventaja Proxmox: Virtualización enterprise con clustering, live migration, y HA. Ideal si tu homelab es principalmente para VMs y necesitas características avanzadas.

Ventaja TrueNAS Scale: Kubernetes integrado para orquestación avanzada de contenedores, ideal si ya conoces K8s.

Interfaz y Facilidad de Uso

Ventaja Unraid: La interfaz más intuitiva y fácil de usar para principiantes. Puedes tener tu NAS funcionando en menos de 30 minutos sin conocimientos avanzados.

Costo y Licencias

Ventaja TrueNAS/Proxmox: Completamente gratis y open source. Ideal si prefieres software libre.

Ventaja Unraid: Aunque requiere pago, la licencia es de por vida y ofrece mejor experiencia de usuario para principiantes.

¿Cuándo Usar Cada Una?

Elige Unraid si:

• ✅ Tienes discos de diferentes tamaños y quieres flexibilidad
• ✅ Buscas simplicidad y facilidad de uso
• ✅ Necesitas Docker fácil de gestionar (Community Applications)
• ✅ Tu homelab es principalmente para almacenamiento + servicios básicos
• ✅ No necesitas clustering o High Availability
• ✅ Estás dispuesto a pagar por una mejor experiencia de usuario

Elige TrueNAS Scale si:

• ✅ Priorizas integridad de datos (ZFS auto-healing, checksums)
• ✅ Necesitas snapshots y replicación avanzada
• ✅ Tienes discos del mismo tamaño o puedes comprarlos
• ✅ Quieres Kubernetes para orquestación avanzada
• ✅ Prefieres software open source gratuito
• ✅ Estás cómodo con configuraciones más complejas

Elige Proxmox si:

• ✅ Necesitas virtualización avanzada (clustering, live migration, HA)
• ✅ Tu homelab es principalmente para VMs
• ✅ Necesitas características enterprise (backup centralizado, clustering)
• ✅ Tienes experiencia con virtualización
• ✅ Prefieres software open source gratuito

Recomendación general: Para la mayoría de usuarios de homelab que buscan simplicidad y flexibilidad de almacenamiento, Unraid es la mejor opción. Si priorizas integridad de datos y tienes discos uniformes, TrueNAS Scale es superior. Si necesitas virtualización enterprise, Proxmox es la elección correcta.

—

Requisitos de Hardware

Mínimos Recomendados

Para un homelab básico con Unraid, necesitas:

• CPU: Procesador multi-core (Intel o AMD) con soporte para 64-bit
• RAM: 16GB mínimo (32GB recomendado si planeas usar VMs)
• Almacenamiento:

– 1 disco de datos mínimo (4TB+ recomendado)

– 1 disco de paridad (recomendado para protección)

– 1 SSD para cache (opcional pero muy recomendado)

• USB: 1GB-32GB para boot (USB 2.0 recomendado por estabilidad)
• Red: Gigabit Ethernet (10GbE opcional para transferencias rápidas)

Recomendaciones para Homelab

CPU:

• Intel: i5/i7 de 8ª generación o superior (Coffee Lake o posterior)
• AMD: Ryzen 5/7 o superior
• Importante: Soporte para virtualización (Intel VT-x / AMD-V) si planeas usar VMs
• IOMMU: Soporte para IOMMU (Intel VT-d / AMD-Vi) si planeas GPU passthrough

RAM:

• 32GB: Para uso básico (NAS + Docker básico)
• 64GB+: Si planeas múltiples VMs o muchos contenedores Docker
• ECC: Opcional pero recomendado para producción (mayor estabilidad)

Almacenamiento:

• Array (HDDs): Discos de 4TB+ (WD Red, Seagate IronWolf, Toshiba N300)
• Parity: Mismo tamaño o mayor que el disco de datos más grande
• Cache (SSD/NVMe): 500GB+ (Samsung 970/980 EVO, WD Black SN750, Crucial P5)
• Cache RAID 1: Recomendado para redundancia (2 discos SSD en mirror)

Motherboard:

• Puertos SATA: Mínimo 6 puertos (más si planeas expandir)
• Slots PCIe: Para expansión (tarjetas SATA, 10GbE, GPU para passthrough)
• IOMMU: Soporte en BIOS/UEFI para GPU passthrough
• USB 2.0: Al menos un puerto USB 2.0 para el flash drive de boot

Red:

• Gigabit Ethernet: Integrado en la mayoría de motherboards modernas
• 10GbE: Opcional pero recomendado si transfieres archivos grandes frecuentemente

Power Supply:

• Calidad: PSU de calidad (80+ Gold o superior)
• Capacidad: Suficiente para todos los discos + componentes (calcular consumo máximo)
• Importante: Asegurar que puede manejar el spin-up simultáneo de todos los discos

Ejemplo de Configuración Típica

Homelab Básico:

• CPU: Intel i5-10400 o AMD Ryzen 5 3600
• RAM: 32GB DDR4
• Array: 4x 4TB HDD (data) + 1x 8TB HDD (parity)
• Cache: 1x 500GB NVMe SSD
• USB: 16GB USB 2.0
• Costo aproximado: ~$800-1000 (sin licencia Unraid)

Homelab Avanzado:

• CPU: Intel i7-12700K o AMD Ryzen 7 5800X
• RAM: 64GB DDR4 ECC
• Array: 8x 8TB HDD (data) + 2x 12TB HDD (dual parity)
• Cache: 2x 1TB NVMe SSD (RAID 1)
• GPU: NVIDIA RTX 3060 (para passthrough)
• 10GbE: Tarjeta de red 10GbE
• Costo aproximado: ~$2000-2500 (sin licencia Unraid)

—

Instalación Paso a Paso

Paso 1: Crear USB Boot

Unraid se ejecuta desde un USB flash drive. Este USB contiene el sistema operativo completo y tu configuración.

Descargar Unraid OS:

1. Visita https://unraid.net/download
2. Descarga la última versión de Unraid OS (actualmente 6.12+)
3. El archivo descargado será un ZIP con los archivos del sistema

Crear USB Bootable:

Opción A: Unraid USB Creator (Recomendado)

1. Descarga Unraid USB Creator desde la página de descarga
2. Ejecuta el USB Creator
3. Selecciona tu USB drive (1GB-32GB, USB 2.0 recomendado)
4. Selecciona el archivo ZIP de Unraid descargado
5. Click Write para crear el USB bootable

Opción B: Manual (Linux/Mac)

# Descomprimir el ZIP
unzip unRAIDServer-*.zip -d /tmp/unraid/

# Identificar tu USB drive (¡CUIDADO! Verifica que sea el correcto)
lsblk  # En Linux
diskutil list  # En Mac

# Copiar archivos al USB (reemplazar /dev/sdX con tu dispositivo)
sudo cp -r /tmp/unraid/* /media/USB/  # Montar USB primero
# O usar dd si prefieres:
# sudo dd if=unRAIDServer-*.zip of=/dev/sdX bs=1M status=progress

Requisitos del USB:

• Tamaño: 1GB-32GB (Unraid recomienda no usar USBs muy grandes)
• Tipo: USB 2.0 recomendado (más estable que USB 3.0 para boot)
• Formato: FAT32 (el USB Creator lo formatea automáticamente)
• Calidad: USB de marca reconocida (evitar USBs genéricos baratos)

Paso 2: Configurar BIOS/UEFI

Antes de bootear Unraid, configura tu BIOS correctamente:

1. Entrar a BIOS: Presiona DEL o F2 durante el boot (depende de tu motherboard)

1. Habilitar XMP/DOCP: Para que la RAM funcione a su velocidad correcta

– Busca «XMP Profile» (Intel) o «DOCP» (AMD)

– Actívalo para tu perfil de RAM

1. Habilitar Virtualization: Necesario para Docker y VMs

– Intel: Busca «Intel Virtualization Technology (VT-x)» → Enable

– AMD: Busca «AMD-V» o «SVM Mode» → Enable

1. Habilitar IOMMU: Solo si planeas GPU passthrough

– Intel: Busca «Intel VT-d» → Enable

– AMD: Busca «IOMMU» o «AMD-Vi» → Enable

1. Configurar Boot Order:

– Configura el USB como primer dispositivo de boot

– O usa boot temporal (F8, F11, F12 dependiendo de tu motherboard)

1. Guardar y Salir: Guarda los cambios y reinicia

Paso 3: Boot Inicial y Primera Configuración

1. Bootear desde USB:

– Inserta el USB en un puerto USB 2.0 (más estable)

– Reinicia el servidor

– Selecciona «Unraid OS» en el menú de boot (si aparece)

1. Esperar carga inicial:

– Unraid cargará el sistema (pantalla mostrará logs)

– Al finalizar, verás una pantalla con información del servidor:

Unraid Server
     Tower
     IP: 192.168.1.100

1. Acceder a la interfaz web:

– Desde cualquier navegador en tu red local, accede a:

– http://tower (si tu red soporta mDNS)

– O http://[IP] (la IP mostrada en pantalla, ej: http://192.168.1.100)

1. Configuración inicial:

– La primera vez verás un asistente de configuración

– Configura:

– Nombre del servidor: Por defecto «Tower» (cámbialo si quieres)

– Workgroup: Por defecto «WORKGROUP»

– DNS: Configura DNS (8.8.8.8, 1.1.1.1, etc.)

Paso 4: Configurar Array de Almacenamiento

Una vez dentro de la interfaz web:

1. Ir a Main → Array Devices

1. Asignar discos:

– Parity Drive: Selecciona tu disco más grande (protege contra fallos)

– Data Drives: Selecciona tus discos de datos (pueden ser de diferentes tamaños)

– Cache Drives: Selecciona tus SSDs/NVMe (opcional pero recomendado)

1. Configurar File System:

– Array: XFS (recomendado) o BTRFS

– Cache: BTRFS (permite snapshots) o XFS

1. Iniciar Array:

– Click Start para iniciar el array

– Advertencia: Si asignaste un disco de paridad, se iniciará un «parity sync» que puede tardar varias horas. El array estará disponible durante este proceso.

Ejemplo de configuración típica:

Array Devices:
  Parity 1: 8TB HDD (WD Red)
  Disk 1: 4TB HDD (Seagate IronWolf)
  Disk 2: 4TB HDD (Seagate IronWolf)
  Disk 3: 6TB HDD (WD Red)
  Disk 4: 6TB HDD (WD Red)

Cache Pool:
  Cache 1: 1TB NVMe SSD (Samsung 980)
  Cache 2: 1TB NVMe SSD (Samsung 980)  # RAID 1

Paso 5: Configurar Shares Básicos

Los shares son directorios lógicos que pueden abarcar múltiples discos. Configura shares esenciales:

1. Ir a Shares

1. Crear shares básicos:

appdata (para Docker):

– Cache setting: Prefer

– Descripción: Datos de aplicaciones Docker

– Los contenedores Docker se ejecutan desde cache para mejor rendimiento

domains (para VMs):

– Cache setting: Prefer

– Descripción: Máquinas virtuales

– Las VMs se ejecutan desde cache para mejor rendimiento

isos (para imágenes ISO):

– Cache setting: No

– Descripción: Imágenes ISO para VMs

– No necesita velocidad, se escribe directamente al array

media (para contenido multimedia):

– Cache setting: Yes

– Descripción: Películas, series, música

– Escribe rápido al cache, luego se mueve al array durante la noche

downloads (para descargas temporales):

– Cache setting: Yes

– Descripción: Descargas temporales

– Escribe rápido al cache, luego se mueve al array

Paso 6: Configurar Red

1. Ir a Settings → Network Settings

1. Configurar IP estática (recomendado):

– Interface: Selecciona tu interfaz de red (eth0, enp0s3, etc.)

– IPv4 address assignment: Static

– IPv4 address: Ej: 192.168.1.100

– IPv4 netmask: 255.255.255.0

– IPv4 gateway: Tu router (ej: 192.168.1.1)

– IPv4 DNS server: 8.8.8.8 o 1.1.1.1

1. Configurar nombre del servidor:

– Server name: Cambia «Tower» por el nombre que prefieras

– Workgroup: Deja «WORKGROUP» o cámbialo según tu red

1. Aplicar cambios: Click Apply

Acceso: Ahora puedes acceder a Unraid usando la IP estática: http://192.168.1.100

—

Configuración de Almacenamiento

Entendiendo el Array de Unraid

El array de Unraid funciona de manera diferente a los sistemas RAID tradicionales:

Cómo funciona:

• Cada disco de datos almacena archivos directamente (no hay striping como en RAID)
• El disco de paridad almacena información de paridad para reconstruir datos si un disco falla
• Si un disco falla, solo pierdes los datos de ese disco específico (no todo el array)
• Puedes leer datos de los discos que siguen funcionando incluso durante la reconstrucción

Ventajas:

• ✅ Flexibilidad: Discos de diferentes tamaños
• ✅ Expansión fácil: Añade discos sin reconstruir
• ✅ Acceso directo: Puedes leer archivos de discos individuales
• ✅ Bajo consumo: Solo los discos necesarios se activan

Desventajas:

• ⚠️ Rendimiento: Más lento que RAID (escritura debe calcular paridad)
• ⚠️ Sin auto-healing: No detecta errores de bit como ZFS

Configuración de Parity

Single Parity (1 disco de paridad):

• Protege contra 1 fallo de disco
• El disco de paridad debe ser ≥ disco de datos más grande
• Ejemplo: Si tienes discos de 4TB, 6TB, 8TB → parity debe ser ≥ 8TB

Dual Parity (2 discos de paridad):

• Protege contra 2 fallos simultáneos
• Requiere licencia Plus o Pro
• Ambos discos de paridad deben ser ≥ disco de datos más grande
• Recomendado para arrays grandes (8+ discos)

Configuración recomendada:

• Arrays pequeños (≤6 discos): Single parity es suficiente
• Arrays grandes (7+ discos): Dual parity recomendado
• Siempre: Usa tus discos más grandes para parity (permite expansión futura)

Cache Pools

Los cache pools mejoran significativamente el rendimiento de escritura:

Cómo funciona:

1. Los datos se escriben primero al cache (SSD/NVMe rápido)
2. El «Mover» transfiere datos del cache al array según programación (por defecto 3:40 AM)
3. Los datos quedan protegidos por parity una vez en el array

Tipos de cache:

Single Cache Drive:

• 1 disco SSD/NVMe
• Sin redundancia (si falla, pierdes datos no movidos)
• Más rápido y económico
• Recomendado para datos no críticos

RAID 1 Cache (Mirror):

• 2 discos SSD/NVMe en mirror
• Redundancia (si un disco falla, el otro tiene los datos)
• Recomendado para datos importantes (appdata, domains)

Configuración recomendada:

• appdata y domains: Cache «Prefer» con RAID 1 (redundancia + rendimiento)
• media y downloads: Cache «Yes» con single drive (velocidad, datos no críticos)
• backups: Cache «No» (no necesita velocidad)

Configuración de Shares

Los shares tienen diferentes opciones de cache:

Ejemplo de configuración de shares:

Shares recomendados:
  appdata:
    Cache: Prefer
    Uso: Datos de Docker (configuraciones, bases de datos)
    
  domains:
    Cache: Prefer
    Uso: VMs (discos virtuales)
    
  media:
    Cache: Yes
    Uso: Películas, series, música
    
  downloads:
    Cache: Yes
    Uso: Descargas temporales
    
  isos:
    Cache: No
    Uso: Imágenes ISO para VMs
    
  backups:
    Cache: No
    Uso: Backups del sistema

Mover Utility

El Mover es un proceso automático que transfiere datos del cache al array:

Configuración:

• Ubicación: Settings → Scheduler → Mover Settings
• Programación por defecto: 3:40 AM diariamente
• Recomendación: Ejecutar durante horas de bajo uso (noche)

Ejecutar manualmente:

• Main → Click en el icono del Mover
• O desde terminal: /usr/local/sbin/mover

Monitoreo:

• Ver progreso en Main → Array Operations
• El Mover solo mueve archivos que están en cache y deben ir al array (según configuración de share)

—

Docker en Unraid: Community Applications

Una de las mayores ventajas de Unraid es la facilidad para instalar y gestionar aplicaciones Docker gracias a Community Applications (CA).

Instalar Community Applications

Community Applications es un plugin que proporciona un catálogo de más de 2,000 aplicaciones Docker preconfiguradas.

Instalación:

1. Ir a Plugins
2. Click Install Plugin
3. Pegar esta URL:

https://raw.githubusercontent.com/Squidly271/community.applications/master/plugins/community.applications.plg

1. Click Install
2. Esperar a que se instale (aparecerá mensaje de confirmación)
3. Refrescar la página (F5) – Aparecerá la pestaña Apps

Usar Community Applications

Una vez instalado, verás la pestaña Apps en la interfaz principal:

1. Buscar aplicación: Usa la barra de búsqueda (ej: «Plex», «Nextcloud», «Home Assistant»)

1. Ver detalles: Click en el tile de la aplicación para ver:

– Descripción

– Variables de entorno necesarias

– Paths recomendados

– Enlaces de soporte

1. Instalar: Click Install y se abrirá un formulario con:

– Repository: Imagen Docker (ya preconfigurada)

– Container Name: Nombre del contenedor

– Variables: Variables de entorno (PUID, PGID, TZ, etc.)

– Paths: Mapeo de volúmenes (ya sugeridos)

– Ports: Puertos de red (ya sugeridos)

1. Configurar y aplicar:

– Revisa y ajusta la configuración según tus necesidades

– Click Apply para crear el contenedor

1. Gestionar: Una vez instalado, puedes:

– Ver logs: Click en el icono del contenedor → Logs

– Editar: Click en el icono → Edit

– Actualizar: Apps → Installed Apps → Check for Updates

– Eliminar: Click en el icono → Remove

Contenedores Populares para Homelab

Media Servers:

• Plex: Servidor de streaming de medios (alternativa: Jellyfin, Emby)
• Jellyfin: Alternativa open source a Plex
• Sonarr/Radarr: Gestión automática de series y películas

File Management:

• Nextcloud: Nube privada (alternativa a Google Drive/Dropbox)
• FileBrowser: Explorador de archivos web simple
• Syncthing: Sincronización de archivos P2P

Home Automation:

• Home Assistant: Automatización del hogar
• Node-RED: Automatización visual con flujos

Utilities:

• qBittorrent: Cliente torrent
• Portainer: Gestión de Docker con UI (aunque Unraid ya tiene UI)
• Watchtower: Auto-update de contenedores (alternativa: CA Auto Update)

Ejemplo: Instalar Plex

Vamos a instalar Plex paso a paso como ejemplo:

1. Buscar Plex:

– Apps → Buscar «Plex»

– Seleccionar «Plex Media Server» (linuxserver.io)

1. Configurar:

Container Name: plex
   Repository: linuxserver/plex:latest
   Network Type: bridge
   
   Ports:
     - 32400:32400 (Web UI)
     - 32400:32400/udp (Discovery)
     - 32469:32469 (DLNA)
   
   Paths:
     - /mnt/user/appdata/plex:/config
     - /mnt/user/media:/media
   
   Environment Variables:
     - PUID=99 (usuario nobody)
     - PGID=100 (grupo users)
     - TZ=Europe/Madrid
     - VERSION=docker

1. Aplicar: Click Apply y esperar a que se descargue e inicie

1. Acceder: Abre http://[IP-Unraid]:32400/web para configurar Plex

Nota: Los paths /mnt/user/appdata/plex y /mnt/user/media deben existir como shares. Si no los has creado, créalos primero en Shares.

Gestionar Contenedores Docker

Ver contenedores instalados:

• Docker → Ver todos los contenedores
• Apps → Installed Apps → Ver solo apps de Community Applications

Actualizar contenedores:

• Apps → Installed Apps → Check for Updates
• Aparecerán contenedores con actualizaciones disponibles
• Click Update en cada uno, o Update All para actualizar todos

Logs y troubleshooting:

• Click en el icono del contenedor → Logs
• Ver errores, warnings, y actividad del contenedor
• Útil para diagnosticar problemas

Editar configuración:

• Click en el icono → Edit
• Modificar variables, paths, ports, etc.
• Click Apply para aplicar cambios (el contenedor se recreará)

—

Máquinas Virtuales (VMs) y GPU Passthrough

Unraid soporta máquinas virtuales usando KVM, permitiendo ejecutar sistemas operativos completos como Windows, Linux, o macOS (con limitaciones).

Crear una VM Básica

1. Ir a VMs

1. Click Add VM

1. Seleccionar template:

– Windows (10/11)

– Linux (various)

– macOS (requiere hardware específico)

– Otros

1. Configurar recursos:

– Name: Nombre de la VM (ej: «Windows-Gaming»)

– Description: Descripción opcional

– CPU: Cores asignados (ej: 4 cores de 8 disponibles)

– Memory: RAM asignada (ej: 16GB de 32GB disponibles)

– Machine: Tipo de máquina (Q35 recomendado para Windows moderno)

– BIOS: SeaBIOS o OVMF (UEFI) – OVMF recomendado para Windows 10/11

1. Configurar almacenamiento:

– Primary vDisk Location: /mnt/user/domains/ (en cache para mejor rendimiento)

– Primary vDisk Size: Tamaño del disco virtual (ej: 200GB)

– Primary vDisk Type: RAW (recomendado) o QCOW2

1. Configurar red:

– Network Model: VirtIO (mejor rendimiento) o e1000 (compatibilidad)

– Network Bridge: br0 (bridge por defecto)

1. Configurar gráficos:

– Graphics Card: VNC (por defecto, acceso remoto) o GPU passthrough

– VNC: Acceso desde navegador o cliente VNC

1. Crear: Click Create y esperar a que se cree el disco virtual

1. Iniciar: Click Start y luego VNC Remote para acceder a la consola

GPU Passthrough

GPU passthrough permite asignar una GPU física directamente a una VM, permitiendo gaming o workloads intensivos con rendimiento nativo.

Requisitos:

• CPU con soporte IOMMU (Intel VT-d / AMD-Vi)
• GPU dedicada (no la integrada del servidor)
• BIOS/UEFI con IOMMU habilitado
• Licencia Unraid Plus o Pro (Basic no soporta VMs)

Pasos para configurar GPU Passthrough:

1. Habilitar IOMMU en BIOS:

• Intel: Habilitar «Intel VT-d»
• AMD: Habilitar «IOMMU» o «AMD-Vi»
• Guardar y reiniciar

2. Habilitar IOMMU en Unraid:

• Settings → VM Manager
• Enable IOMMU: Yes
• Aplicar cambios y reiniciar

3. Identificar GPU y audio device:

• Tools → System Devices
• Buscar tu GPU (ej: «NVIDIA Corporation [10DE:2504]»)
• Buscar el audio device asociado (ej: «NVIDIA Corporation [10DE:228E]»)
• Anotar los IDs (ej: 0000:01:00.0 y 0000:01:00.1)

4. Bind GPU a VFIO:

• En System Devices, marcar la casilla junto a tu GPU
• Marcar la casilla junto al audio device de la GPU
• Click Bind Selected to VFIO at Boot
• Reiniciar el servidor

5. Configurar VM con GPU:

• Crear o editar una VM
• Graphics Card: Seleccionar tu GPU de la lista
• Sound Card: Seleccionar el audio device de la GPU
• USB Devices: Añadir teclado y ratón si es necesario

6. Instalar drivers en la VM:

• Una vez iniciada la VM, instala los drivers de GPU correspondientes:

– NVIDIA: Descargar drivers desde nvidia.com

– AMD: Descargar drivers desde amd.com

Nota importante: Una vez bindeada a VFIO, la GPU quedará inaccesible para el host Unraid. Solo podrás usarla en la VM asignada.

Ejemplo: VM Windows 11 con GPU para Gaming

VM Configuration:
  Name: Windows-Gaming
  OS: Windows 11
  CPU: 8 cores (de 16 disponibles)
  Memory: 16GB (de 32GB disponibles)
  Machine: Q35-7.1
  BIOS: OVMF (UEFI)
  
  Primary vDisk:
    Location: /mnt/user/domains/Windows-Gaming/
    Size: 500GB
    Type: RAW
    Cache: Prefer (en cache para mejor rendimiento)
  
  Graphics Card: NVIDIA RTX 3060 (passthrough)
  Sound Card: NVIDIA High Definition Audio (passthrough)
  
  USB Devices:
    - Keyboard (passthrough)
    - Mouse (passthrough)
    - Gamepad (opcional, passthrough)
  
  Network:
    Model: VirtIO
    Bridge: br0

Rendimiento esperado:

• Gaming: 95-98% del rendimiento nativo (overhead mínimo)
• Workloads GPU: Rendimiento casi nativo para CUDA, OpenCL, etc.

—

Plugins y Extensiones Esenciales

Los plugins extienden la funcionalidad de Unraid. Aquí están los esenciales:

Plugins Recomendados

1. Community Applications

• Qué hace: Catálogo de 2,000+ aplicaciones Docker preconfiguradas
• Por qué es esencial: Sin esto, instalar Docker sería mucho más complicado
• Instalación: Ver sección anterior «Docker en Unraid»

2. Fix Common Problems

• Qué hace: Escanea tu sistema y detecta problemas comunes
• Por qué es útil: Encuentra errores de configuración, plugins obsoletos, problemas de red, etc.
• Instalación: Apps → Buscar «Fix Common Problems» → Install

3. Unassigned Devices

• Qué hace: Permite montar discos externos, USBs, o discos no asignados al array
• Por qué es útil: Para backups temporales, transferir datos, o usar discos externos
• Instalación: Apps → Buscar «Unassigned Devices» → Install

4. CA Backup / Appdata Backup

• Qué hace: Backup automático de configuración (flash drive, appdata, VMs)
• Por qué es esencial: Protege tu configuración y datos de aplicaciones
• Instalación: Apps → Buscar «CA Backup» → Install
• Configuración: Programar backups automáticos a ubicación externa o red

5. Dynamix System Buttons

• Qué hace: Añade botones de control (shutdown, reboot, etc.) en la UI
• Por qué es útil: Control rápido del servidor desde la interfaz web
• Instalación: Apps → Buscar «Dynamix System Buttons» → Install

6. User Scripts

• Qué hace: Ejecuta scripts personalizados con programación (cron)
• Por qué es útil: Automatizar tareas, backups personalizados, mantenimiento
• Instalación: Apps → Buscar «User Scripts» → Install

7. NerdTools

• Qué hace: Instala herramientas de línea de comandos adicionales (htop, nano, git, etc.)
• Por qué es útil: Si usas terminal frecuentemente, añade herramientas útiles
• Instalación: Apps → Buscar «NerdTools» → Install

Instalación de Plugins

Método 1: Desde Community Applications (Recomendado)

1. Apps → Buscar nombre del plugin
2. Click Install
3. Seguir instrucciones si las hay
4. Refrescar página si es necesario

Método 2: Manual

1. Plugins → Install Plugin
2. Pegar URL del archivo .plg del plugin
3. Click Install

Actualizar plugins:

• Plugins → Check for Updates
• O Apps → Installed Apps → Check for Updates (si el plugin está en CA)

—

Backup y Seguridad

Backup de Configuración

Tu configuración de Unraid está en el USB flash drive. Es crítico hacer backups regulares.

CA Backup Plugin (Recomendado):

1. Instalar CA Backup: Apps → Buscar «CA Backup» → Install

1. Configurar destino:

– Local: Disco externo montado con Unassigned Devices

– Network: SMB/NFS share en otro servidor

– Cloud: Google Drive, Dropbox, etc. (requiere configuración adicional)

1. Configurar qué respaldar:

– ✅ Flash drive (configuración completa)

– ✅ appdata (datos de Docker)

– ✅ VMs (máquinas virtuales)

– ✅ Plugins (lista de plugins instalados)

1. Programar backups:

– Settings → Scheduler

– Configurar frecuencia (diario, semanal, etc.)

– Ejecutar durante horas de bajo uso

Backup Manual:

# Backup del flash drive (desde otro sistema)
# Montar USB en Linux/Mac y copiar carpeta /config
cp -r /media/USB/config/ /backup/unraid-config-$(date +%Y%m%d)/

# Backup de appdata (desde Unraid o otro sistema)
rsync -av /mnt/user/appdata/ /mnt/disks/backup/appdata/

# Backup de VMs
rsync -av /mnt/user/domains/ /mnt/disks/backup/domains/

Estrategia 3-2-1:

• 3 copias: Original + 2 backups
• 2 medios diferentes: USB + disco externo, o local + cloud
• 1 offsite: Al menos un backup fuera del servidor (cloud, otro lugar físico)

Seguridad

1. Cambiar Contraseña por Defecto

• Settings → Users
• Click en usuario «root»
• Cambiar contraseña (usa contraseña fuerte)
• Importante: La contraseña por defecto es «password» – cámbiala inmediatamente

2. Deshabilitar Root SSH (Recomendado)

• Settings → SSH
• Permit root login: No
• Crear usuario no-root para SSH si lo necesitas

3. Habilitar HTTPS

• Settings → Identification
• Use SSL/TLS: Yes
• Certificate: Auto (usa certificado autofirmado) o importa certificado válido
• Acceso: https://[IP] (el navegador mostrará advertencia con certificado autofirmado)

4. Firewall

• Configurar reglas en tu router/firewall
• Solo exponer puertos necesarios
• Considerar VPN para acceso remoto (WireGuard, Tailscale)

5. VPN para Acceso Remoto

• WireGuard: Plugin disponible en Community Applications
• Tailscale: Contenedor Docker disponible
• Recomendación: Usa VPN en lugar de exponer puertos directamente

6. Actualizaciones

• Settings → OS Update
• Mantener Unraid actualizado (actualizaciones de seguridad)
• Actualizar plugins regularmente (Plugins → Check for Updates)

7. Permisos de Shares

• Shares → Configurar permisos por share
• Usar usuarios específicos en lugar de «Public»
• Configurar SMB permissions según necesidades

—

Troubleshooting: Errores Comunes

Error 1: Server No Arranca o Se Detiene Durante Boot

Síntomas:

• El servidor no inicia
• Se detiene durante el proceso de boot
• Pantalla negra o mensajes de error

Soluciones:

1. Verificar USB:

– Usar puerto USB 2.0 (más estable que USB 3.0)

– Probar con otro USB drive

– Verificar que el USB esté correctamente formateado

1. Verificar Boot Order en BIOS:

– Asegurar que USB esté configurado como primer dispositivo de boot

– O usar boot temporal (F8, F11, F12)

1. Boot en Safe Mode:

– En el menú de boot de Unraid, seleccionar «Unraid OS (Safe Mode)»

– Esto desactiva plugins y puede identificar problemas de plugins

1. Verificar USB en Otro Sistema:

– Montar USB en otro sistema y verificar que los archivos estén correctos

– Re-extraer archivos de Unraid al USB si es necesario

1. Reconstruir USB:

– Crear nuevo USB con Unraid USB Creator

– Copiar solo la carpeta /config del USB antiguo al nuevo

– Esto preserva tu configuración

Error 2: Crashes y Inestabilidad

Síntomas:

• Crashes aleatorios
• Freezes del sistema
• Rendimiento degradado
• Kernel panics

Soluciones:

1. Power Supply (PSU):

– Verificar que el PSU tenga suficiente capacidad

– Calcular consumo máximo: Todos los discos + CPU + GPU + otros componentes

– Usar PSU de calidad (80+ Gold o superior)

– Importante: El PSU debe poder manejar el spin-up simultáneo de todos los discos

1. Temperatura:

– Mantener servidor en área bien ventilada

– Temperatura ambiente recomendada: 18-24°C (64-75°F)

– Verificar temperaturas: Main → Ver temperaturas de CPU y discos

– Limpiar polvo de ventiladores y heatsinks regularmente

1. Health de Discos:

– Main → Click en disco → Ver SMART attributes

– Buscar errores, reallocated sectors, etc.

– Reemplazar discos con problemas antes de que fallen completamente

1. Plugins Problemáticos:

– Boot en Safe Mode para identificar plugins que causan problemas

– Desinstalar plugins recientemente instalados uno por uno

– Preferir contenedores Docker sobre plugins cuando sea posible

1. Firmware y BIOS:

– Actualizar BIOS/UEFI a última versión

– Verificar que XMP/DOCP esté configurado correctamente

– Actualizar Unraid a última versión estable

1. RAM:

– Ejecutar memtest86+ para verificar errores de RAM

– Verificar que la RAM esté correctamente instalada

– Probar con una sola stick de RAM para aislar problemas

Error 3: Docker Containers No Inician

Síntomas:

• Contenedores no arrancan
• Errores al iniciar contenedores
• Mensajes de error en logs

Soluciones:

1. Recrear Docker Image:

Settings → Docker
   Enable Docker: No
   (Esto detiene Docker y permite eliminar docker.img)
   Delete docker.img
   Enable Docker: Yes
   (Esto recrea docker.img limpio)

Nota: Esto NO elimina tus contenedores si están configurados correctamente (datos en appdata)

1. Verificar Paths:

– Asegurar que los paths apunten a shares existentes

– Verificar permisos de los paths (PUID/PGID correctos)

– Ejemplo: /mnt/user/appdata/plex debe existir como share

1. Verificar Permisos:

– PUID=99 (usuario nobody)

– PGID=100 (grupo users)

– Verificar que estos sean correctos en la configuración del contenedor

1. Verificar Puertos:

– Asegurar que los puertos no estén en conflicto

– Verificar que no haya otro servicio usando el mismo puerto

– Cambiar puerto si es necesario (ej: 32400 → 32401)

1. Actualizar Contenedores:

– Apps → Installed Apps → Check for Updates

– Actualizar contenedores a última versión

– A veces versiones antiguas tienen bugs conocidos

1. Ver Logs:

– Click en icono del contenedor → Logs

– Buscar mensajes de error específicos

– Buscar en foros de Unraid o documentación del contenedor

Error 4: Array No Inicia

Síntomas:

• Array no arranca al iniciar Unraid
• Discos no detectados
• Errores al iniciar array

Soluciones:

1. Verificar Conexiones SATA:

– Verificar que todos los cables SATA estén bien conectados

– Probar con otros puertos SATA en la motherboard

– Verificar alimentación de los discos (cables de alimentación)

1. Verificar Asignación de Discos:

– Main → Array Devices

– Verificar que los discos estén asignados correctamente

– Asegurar que el disco de paridad sea ≥ disco de datos más grande

1. Verificar Logs:

– Tools → System Log

– Buscar mensajes de error relacionados con discos

– Buscar mensajes de «device not found» o «I/O error»

1. Probar Discos en Otro Sistema:

– Conectar discos a otro sistema

– Verificar que los discos sean detectados

– Ejecutar SMART tests en los discos

1. Verificar Alimentación:

– Asegurar que el PSU tenga suficiente capacidad

– Verificar que todos los discos reciban alimentación

– Considerar usar múltiples cables de alimentación si tienes muchos discos

1. Reasignar Discos:

– Si un disco no se detecta, intenta reasignarlo manualmente

– Main → Array Devices → Seleccionar disco de la lista

– Si el disco aparece como «unassigned», puedes asignarlo de nuevo

Error 5: Rendimiento Lento

Síntomas:

• Transferencias de archivos lentas
• VMs lentas
• Docker containers lentos
• Sistema general lento

Soluciones:

1. Configurar Cache Correctamente:

– Asegurar que shares críticos (appdata, domains) usen cache «Prefer»

– Verificar que el cache tenga espacio disponible

– Considerar añadir más cache si es necesario

1. Verificar Red:

– Asegurar que esté en Gigabit (1000 Mbps), no Fast Ethernet (100 Mbps)

– Verificar cables de red (usar Cat5e o superior)

– Probar con otro cable de red

1. Verificar Health de Discos:

– Discos con problemas pueden causar lentitud

– Verificar SMART attributes de todos los discos

– Reemplazar discos con errores

1. Verificar RAM:

– Asegurar suficiente RAM disponible

– Verificar que no haya memory leaks

– Considerar añadir más RAM si es necesario

1. Verificar CPU:

– Verificar que la CPU no esté al 100%

– Tools → System Stats → Ver uso de CPU

– Identificar procesos que consumen CPU

1. Parity Sync en Progreso:

– Si hay un parity sync en progreso, el rendimiento será menor

– Main → Array Operations → Ver progreso

– Esperar a que termine (puede tardar varias horas)

1. Mover en Ejecución:

– Si el Mover está transfiriendo datos del cache al array, puede afectar rendimiento

– Programar Mover para horas de bajo uso

– O ejecutar manualmente cuando no estés usando el servidor

—

Mejores Prácticas y Optimización

Almacenamiento

1. Usar Discos de Parity

• Siempre usa al menos un disco de paridad para protección
• Para arrays grandes (7+ discos), considera dual parity
• Usa tus discos más grandes para parity (permite expansión futura)

2. Configurar Cache Correctamente

• appdata y domains: Cache «Prefer» con RAID 1 (redundancia + rendimiento)
• media y downloads: Cache «Yes» con single drive (velocidad)
• backups: Cache «No» (no necesita velocidad)

3. Monitorear Health de Discos

• Revisar SMART attributes regularmente (mensual)
• Configurar notificaciones para errores de disco
• Reemplazar discos antes de que fallen completamente

4. Expansión del Array

• Añade discos cuando los necesites (no necesitas comprarlos todos a la vez)
• El disco de paridad debe ser ≥ disco de datos más grande
• Puedes añadir discos sin parar el array (con precaución)

5. File System

• Array: XFS recomendado (mejor rendimiento, menos overhead)
• Cache: BTRFS si quieres snapshots, XFS si priorizas rendimiento

Docker

1. Almacenar Datos en appdata

• Nunca almacenes datos variables dentro de docker.img
• Usa paths como /mnt/user/appdata/[container]/ para datos
• Esto permite backups fáciles y evita corrupción de docker.img

2. Usar Community Applications

• Siempre prefiere aplicaciones de Community Applications
• Están preconfiguradas y mantenidas por la comunidad
• Más fácil de actualizar y gestionar

3. Actualizar Regularmente

• Apps → Installed Apps → Check for Updates
• Mantener contenedores actualizados (seguridad y features)
• Revisar changelogs antes de actualizar (puede haber breaking changes)

4. Backup de appdata

• Incluir appdata en tu estrategia de backup
• CA Backup puede hacerlo automáticamente
• appdata contiene configuraciones y bases de datos importantes

5. Limitar Recursos si es Necesario

• Si un contenedor consume demasiados recursos, limítalos
• Docker → Click en contenedor → Edit → Advanced View
• Configurar CPU pinning o límites de RAM

VMs

1. vDisks en Cache

• Siempre coloca vDisks en cache (share «domains» con cache «Prefer»)
• Mejora significativamente el rendimiento de VMs
• Usa RAID 1 cache para redundancia

2. GPU Passthrough Solo si Necesario

• GPU passthrough consume recursos y hace la GPU inaccesible para el host
• Solo úsalo si realmente necesitas rendimiento GPU nativo
• Para uso básico, VNC es suficiente

3. Asignar Recursos Apropiados

• No sobre-asignar CPU o RAM
• Deja recursos para el host Unraid y Docker
• Regla general: No asignar más del 80% de recursos totales a VMs

4. Backup de VMs

• Incluir VMs en tu estrategia de backup
• CA Backup puede hacerlo automáticamente
• O usar scripts personalizados con User Scripts

5. Snapshots Antes de Cambios

• Si vas a hacer cambios importantes en una VM, crea un snapshot primero
• Facilita rollback si algo sale mal
• Nota: Snapshots requieren BTRFS en el share de domains

Mantenimiento

1. Actualizaciones Regulares

• Settings → OS Update → Mantener Unraid actualizado
• Plugins → Check for Updates → Actualizar plugins
• Apps → Check for Updates → Actualizar contenedores Docker

2. Monitoreo de Logs

• Revisar System Log regularmente (semanal)
• Tools → System Log → Buscar warnings o errors
• Configurar notificaciones para errores críticos

3. Backups Automáticos

• Configurar CA Backup para backups automáticos
• Programar durante horas de bajo uso
• Verificar que los backups se estén ejecutando correctamente

4. Limpieza de Cache

• Monitorear espacio en cache
• Si el cache se llena, el Mover puede no funcionar correctamente
• Considerar añadir más cache si es necesario

5. Documentación

• Documentar tu configuración (shares, contenedores, VMs)
• Guardar screenshots de configuraciones importantes
• Mantener un registro de cambios y modificaciones

—

Preguntas Frecuentes

¿Unraid es gratuito?

No, Unraid requiere una licencia de pago. Las opciones son:

• Basic: $59 (hasta 6 dispositivos)
• Plus: $89 (hasta 12 dispositivos)
• Pro: $129 (dispositivos ilimitados)

TrueNAS Scale y Proxmox son alternativas gratuitas y open source, pero Unraid ofrece mejor experiencia de usuario para principiantes.

¿Puedo usar discos de diferentes tamaños?

Sí, esa es una de las mayores ventajas de Unraid. Puedes mezclar discos de 4TB, 6TB, 8TB, etc. sin problemas. Solo el disco de paridad debe ser igual o mayor que el disco de datos más grande.

¿Qué pasa si un disco falla?

Con single parity, si un disco falla:

• Solo pierdes los datos de ese disco específico
• Los demás discos siguen funcionando normalmente
• Puedes reconstruir los datos del disco fallido usando el disco de paridad
• Reemplaza el disco fallido y Unraid reconstruirá automáticamente

Con dual parity, puedes sobrevivir a 2 fallos simultáneos.

¿Unraid es más lento que RAID?

Sí, Unraid es generalmente más lento que RAID tradicional para escritura porque debe calcular y escribir paridad. Sin embargo:

• Para lectura, el rendimiento es similar (acceso directo a discos)
• El cache mejora significativamente el rendimiento de escritura
• Para la mayoría de casos de uso de homelab, la diferencia no es notable

¿Puedo añadir discos después sin perder datos?

Sí, puedes añadir discos al array en cualquier momento:

1. Apaga el servidor
2. Añade el nuevo disco
3. Arranca Unraid
4. Main → Array Devices → Asigna el nuevo disco
5. Inicia el array (el nuevo disco se formateará automáticamente)

Importante: El disco de paridad debe ser ≥ disco de datos más grande. Si añades un disco más grande que tu parity actual, necesitarás reemplazar el parity primero.

¿Necesito cache?

No es estrictamente necesario, pero muy recomendado. El cache:

• Mejora significativamente el rendimiento de escritura
• Es esencial para appdata y domains (Docker y VMs)
• Puedes empezar con un solo SSD y añadir otro después para RAID 1

¿Puedo usar Unraid sin licencia?

Sí, Unraid tiene un modo de prueba de 30 días. Después necesitas una licencia para continuar usando todas las funciones. Sin licencia, algunas funciones están limitadas.

¿Unraid soporta ZFS?

No nativamente. Unraid usa XFS o BTRFS para el array. Si necesitas ZFS (auto-healing, snapshots avanzados), TrueNAS Scale es una mejor opción.

¿Puedo usar Unraid para producción?

Unraid está diseñado para homelabs y pequeñas oficinas. Para producción enterprise, considera:

• TrueNAS Scale (mejor integridad de datos con ZFS)
• Proxmox (mejor para virtualización enterprise)
• Soluciones comerciales (Synology, QNAP, etc.)

¿Cómo actualizo Unraid?

1. Settings → OS Update
2. Verificar versión disponible
3. Click Download para descargar la actualización
4. Click Apply Update para aplicar
5. El servidor se reiniciará automáticamente

Recomendación: Haz backup antes de actualizar (especialmente actualizaciones mayores).

¿Puedo usar Unraid con menos de 16GB de RAM?

Técnicamente sí, pero no es recomendado. Con menos RAM:

• Menos espacio para cache del sistema
• Limitaciones para Docker y VMs
• Posible inestabilidad

16GB es el mínimo recomendado, 32GB es ideal.

¿Unraid soporta clustering o High Availability?

No, Unraid no soporta clustering ni HA. Si necesitas estas características, Proxmox es una mejor opción.

¿Puedo migrar desde TrueNAS a Unraid?

Sí, pero requiere:

1. Backup de todos los datos
2. Formatear discos (Unraid usa XFS/BTRFS, no ZFS)
3. Restaurar datos desde backup
4. Reconfigurar aplicaciones y servicios

No hay migración directa automática.

¿Qué es Community Applications?

Community Applications es un plugin que proporciona un catálogo de más de 2,000 aplicaciones Docker preconfiguradas. Hace que instalar aplicaciones como Plex, Nextcloud, Home Assistant, etc. sea tan fácil como instalar una app en tu teléfono.

¿Puedo usar GPU passthrough con cualquier GPU?

Casi cualquier GPU moderna funciona, pero:

• NVIDIA: Funciona bien, pero puede requerir configuración adicional para evitar error 43
• AMD: Generalmente funciona sin problemas adicionales
• GPU integrada: No recomendado (el host la necesita)

¿Cuánto tiempo tarda un parity sync?

Depende del tamaño del disco de paridad y velocidad de los discos:

• 8TB: ~8-12 horas
• 12TB: ~12-18 horas
• 16TB+: 18-24+ horas

El array está disponible durante el parity sync, pero el rendimiento será menor.

—

📥 Recursos y Ejemplos Descargables

Repositorio GitHub con Todos los Ejemplos

Todos los scripts, configuraciones y ejemplos de este tutorial están disponibles en:

🔗 GitHub: learningaiagents/homelab/unraid-nas-homelab-guia-completa-2025

Incluye:

• ✅ Scripts de backup automatizados
• ✅ Configuraciones de ejemplo (shares, usuarios)
• ✅ Ejemplo docker-compose para referencia
• ✅ Scripts de mantenimiento
• ✅ Troubleshooting adicional

Clonar todo:

git clone https://github.com/ziruelen/learningaiagents.git
cd learningaiagents/homelab/unraid-nas-homelab-guia-completa-2025/

Otros Recursos Útiles

• Documentación Oficial Unraid: https://docs.unraid.net/ – Guía completa oficial
• Unraid Forums: https://forums.unraid.net/ – Comunidad muy activa, soporte excelente
• SpaceInvaderOne YouTube: Tutoriales avanzados de Unraid (GPU passthrough, optimizaciones, etc.)
• IbraCorp YouTube: Guías de Unraid y homelab en general
• TRaSH Guides: https://trash-guides.info/ – Guías avanzadas de configuración para *arr stack y más

—

🔗 Artículos Relacionados

Continúa aprendiendo con estas guías complementarias:

• TrueNAS Scale: NAS Potente con Docker y ZFS para tu Homelab (Guía Completa 2025) – Alternativa open source con ZFS
• Portainer: Controla Docker y Swarm con UI Pro 2025 – Gestión avanzada de Docker
• Jellyfin Media Server: Guía Completa para Homelab 2025 – Servidor multimedia open source
• Nextcloud: Tu Nube Privada Self-Hosted (Guía Completa 2025) – Nube privada alternativa a Google Drive
• Heimdall: Dashboard Personalizado para tu Homelab (Guía Completa 2025) – Dashboard para gestionar todos tus servicios
• Docker Compose: De 0 a Homelab Completo en 2025 – Fundamentos de Docker Compose
• Pi-hole: Bloquea Todos los Anuncios de tu Red con Docker (Guía Completa 2025) – Bloqueador de anuncios para tu red
• Vaultwarden: Tu Gestor de Contraseñas Self-Hosted en Docker (Guía Completa 2025) – Gestor de contraseñas self-hosted

—

Conclusión

Resumen de Puntos Clave

En este tutorial has aprendido:

✅ Qué es Unraid – Sistema operativo NAS flexible que acepta discos de diferentes tamaños

✅ Comparativa con alternativas – Cuándo elegir Unraid vs TrueNAS vs Proxmox

✅ Instalación completa – Desde crear USB boot hasta configurar array y shares

✅ Configuración de almacenamiento – Array, parity, cache pools, y shares

✅ Docker con Community Applications – Más de 2,000 aplicaciones preconfiguradas

✅ Máquinas virtuales y GPU passthrough – Crear VMs y asignar GPU dedicada

✅ Plugins esenciales – Extender funcionalidad de Unraid

✅ Backup y seguridad – Proteger tu configuración y datos

✅ Troubleshooting – Solucionar problemas comunes

✅ Mejores prácticas – Optimizar rendimiento y mantenimiento

Próximos Pasos Recomendados

Para comenzar HOY:

1. Descargar Unraid – https://unraid.net/download y crear USB boot
2. Instalar en tu servidor – Seguir pasos de instalación de esta guía
3. Configurar array básico – Empezar con 2-3 discos + parity + cache
4. Instalar Community Applications – Acceso a 2,000+ aplicaciones Docker
5. Instalar tu primera app – Plex, Nextcloud, o Home Assistant

Para profundizar:

• 📖 Lee: TrueNAS Scale vs Unraid – Comparativa detallada
• 🎓 Aprende: SpaceInvaderOne YouTube – Tutoriales avanzados de Unraid
• 🛠️ Practica: Configura GPU passthrough para una VM Windows de gaming
• 🔧 Optimiza: Configura backups automáticos y monitoreo de discos

💬 Recursos y Ayuda

Si tienes dudas con Unraid:

• 📚 Repo GitHub: learningaiagents – Ejemplos y código de este tutorial
• 🌐 Foros Unraid: https://forums.unraid.net/ – Comunidad muy activa y útil, soporte excelente
• 📖 Documentación Oficial: https://docs.unraid.net/ – Guía completa oficial
• 🎥 SpaceInvaderOne YouTube: Tutoriales avanzados de Unraid (GPU passthrough, optimizaciones)

¿Te resultó útil? Comparte este tutorial 🙏

—

Recursos Adicionales:

• Documentación Oficial Unraid: https://docs.unraid.net/
• Unraid Forums: https://forums.unraid.net/
• Community Applications: Disponible en Apps después de instalar el plugin
• Ejemplos de Código: GitHub learningaiagents/homelab/unraid-nas-homelab-guia-completa-2025