TrueNAS SCALE
KumoYami como app personalizada en TrueNAS SCALE (Community Edition).
Las versiones recientes de TrueNAS SCALE (24.10 «Electric Eel» y posteriores, ahora TrueNAS Community Edition) usan Docker para las apps y permiten instalar una app personalizada a partir de un YAML de Docker Compose. Las versiones anteriores usaban Kubernetes y no admiten este método.
ARM: próximamente
La imagen de KumoYami todavía es solo para procesadores x86_64 (Intel y AMD). La versión para ARM (arm64: Raspberry Pi, Mac con Apple Silicon, VPS y NAS con ARM) llegará en una próxima versión; esta guía se actualizará entonces.
Instalar
Prepara un dataset
Crea un dataset para KumoYami, por ejemplo tank/apps/kumoyami, con una carpeta datos dentro. Desde el Shell de
TrueNAS (System → Shell), dale la carpeta al usuario del contenedor (uid 1000):
mkdir -p /mnt/tank/apps/kumoyami/datos
chown 1000:1000 /mnt/tank/apps/kumoyami/datosCambia tank por el nombre de tu pool.
Da acceso al registro privado
La imagen está en registry.kumoyami.com y necesita tu licencia. En la configuración de Apps, busca el apartado
de registros de Docker (o credenciales de registro) y añade uno con:
- URI / servidor:
registry.kumoyami.com - Usuario: el identificador de tu licencia,
lic_… - Contraseña: la clave
KY1.…entera
Instala la app con YAML
En Apps → Discover Apps, abre el menú de opciones y elige Install via YAML (o la opción equivalente de tu
versión). Nombre: kumoyami. Pega:
services:
web:
image: registry.kumoyami.com/kumoyami:latest
restart: unless-stopped
environment:
DATA_DIR: /app/datos
volumes:
- /mnt/tank/apps/kumoyami/datos:/app/datos
# Datasets que quieras publicar (:ro = solo lectura):
# - /mnt/tank/fotos:/data/fotos:ro
ports:
- "4890:3000"Guarda: TrueNAS descargará la imagen y arrancará la app.
Abre el panel
Visita http://IP-DE-TRUENAS:4890/admin. El código de configuración del asistente está en los registros de la app
(en Apps, abre kumoyami y mira sus logs; busca «Código»). Sigue con el asistente.
Si no encuentras dónde poner las credenciales
La interfaz de TrueNAS cambia entre versiones. Lo que hace falta siempre es lo mismo: que Docker pueda autenticarse
en registry.kumoyami.com con el usuario lic_… y la clave como contraseña. Si tu versión no ofrece credenciales
de registro para las apps, consulta su documentación o escríbenos.
Permisos
KumoYami accede a los datasets montados como uid 1000. Con :ro le basta con poder leerlos; para subir, renombrar o
borrar, el uid 1000 necesita escritura. Revísalo en los permisos (ACL) del dataset.
HTTPS y actualizar
Para el dominio con HTTPS, usa Cloudflare Tunnel o un proxy inverso como
Nginx Proxy Manager, apuntando a IP-DE-TRUENAS:4890. Para actualizar, TrueNAS
ofrece volver a descargar la imagen de la app desde su pantalla de Apps; mira Actualizar.