PrintStash en Unraid

Unraid es un anfitrión razonable para PrintStash cuando los archivos de modelo ya viven ahí. La instalación por Community Applications usa contenedores separados para la API y el frontend, así que hay un detalle de red que importa: los dos contenedores necesitan una red Docker definida por el usuario con DNS por nombre de contenedor funcionando.

La instalación, en orden

Crea la red desde el terminal de Unraid:

docker network create printstash

Instala primero la plantilla PrintStash-API. Configura:

• red: printstash;
• un secreto JWT largo y aleatorio;
• rutas persistentes para archivos, miniaturas, base de datos, staging y copias de seguridad.

Genera el secreto una sola vez:

openssl rand -hex 32

La plantilla de la API aporta el alias de red api. Instala PrintStash-Frontend en la misma red después de que exista la API. Abre http://<unraid-ip>:3000 y completa el asistente de configuración. No hay cuenta de administrador por defecto.

Si el frontend devuelve un 502, revisa la red y el alias api antes de cambiar los ajustes de la aplicación. La red bridge por defecto de Unraid no ofrece la resolución de nombres que espera esta pareja.

Planifica los mapeos de almacenamiento

Deja la base de datos, las miniaturas, el directorio de staging y el appdata normal en un pool de caché o en un SSD si tienes uno. Pon los archivos de modelo de los que PrintStash es dueño en el array cuando la capacidad importe más que la latencia de escritura.

Para un share de Unraid que ya exista, añade otro mapeo de ruta al contenedor de la API. Mapea el share del host a una ruta clara del contenedor, por ejemplo /mnt/models, y luego introduce esa ruta de contenedor en Ajustes -> Volúmenes compartidos.

Usa un mapeo de solo lectura para el primer escaneo si solo quieres indexar. Un volumen compartido con escritura permite que PrintStash devuelva subidas y revisiones a la carpeta, pero no sobrescribe archivos existentes.

Los escaneos programados son la opción predecible para un share de Unraid. Los eventos nativos del sistema de archivos dependen de cómo aparezca la ruta dentro del contenedor y puede que no se comporten como un sistema de archivos local directo.

Copia las dos mitades: el appdata de PrintStash y cualquier share externo de modelos. Una copia de seguridad completa de PrintStash incluye los archivos de los que es dueño, pero no copia los bytes indexados donde están desde el share externo.

Consejos para una máquina modesta

La generación de miniaturas es la parte pesada de un primer escaneo grande. PrintStash renderiza una malla a la vez por defecto, estima el coste en triángulos y se salta la vista previa cuando la malla supera su límite configurado o el que deduce de la memoria. El archivo entra igual en el índice.

Pon un límite de memoria realista al contenedor y baja VAULT_MESH_MEMORY_BUDGET_FRACTION si el host también corre cargas de multimedia, copias de seguridad o descargas. Empieza alrededor de 0.30 a 0.35 en una máquina ocupada y mantén VAULT_MAX_RENDER_JOBS=1 hasta entender el uso de memoria.

El unraid/README.md del repositorio sigue siendo la referencia detallada de instalación, incluida la alternativa con Compose Manager y las rutas actuales de las plantillas.

Antes del escaneo completo, repasa las comprobaciones del montaje del volumen compartido y crea una copia de seguridad de PrintStash ya probada para la parte de la biblioteca que es de la aplicación.