Primeros pasos con PrintStash

La instalación habitual de PrintStash es con Docker Compose. No necesitas Python, Node ni una cuenta en la nube para ejecutar las imágenes publicadas.

Requisitos

• Docker y Docker Compose sobre un host linux/amd64 o linux/arm64
• Alrededor de 1 GB de RAM como mínimo, y 2 GB para ir más holgado con mallas grandes
• 1 o 2 núcleos de CPU
• Espacio para las imágenes de los contenedores, la base de datos, las miniaturas y tus archivos de modelo

Hay soporte para Raspberry Pi 4 y 5, sistemas NAS con ARM y servidores x86 normales. Desde la v0.12.0, la imagen completa genera vistas previas de STEP y STP tanto en ARM como en amd64. La imagen lite, que es la que descarga el fichero Compose ligero, no tesela STEP en ninguna plataforma.

Instalación

Descarga el fichero Compose y arráncalo. No hay ningún clon que mantener ni nada que editar antes, porque todas las variables del fichero traen un valor por defecto que funciona:

mkdir printstash && cd printstash
curl -O https://raw.githubusercontent.com/xiao-villamor/PrintStash/main/docker-compose.yml

docker compose up -d

El fichero Compose descarga imágenes ya construidas, así que no se compila nada en local. Abre http://localhost:3000 cuando los contenedores estén en estado healthy.

No tienes que inventarte un secreto JWT. El valor de ejemplo del fichero Compose está publicado en el repositorio, así que la API lo considera inservible y genera un secreto real en el primer arranque, que guarda en su propia base de datos. Define VAULT_JWT_SECRET tú mismo solo si quieres custodiar ese valor.

Completa el primer arranque

El asistente pide un token de configuración antes que nada, porque el endpoint que crea la primera cuenta no puede exigir un inicio de sesión. Si VAULT_SETUP_TOKEN no está definido, la API genera uno por proceso y lo escribe en su log:

docker compose logs api | grep "setup token"

A partir de ahí, el asistente crea la primera cuenta de administrador y confirma los ajustes de almacenamiento y de copias de seguridad. No hay usuario ni contraseña por defecto. Reiniciar el contenedor api a mitad de la configuración invalida el token que salió en el log, así que vuelve a hacer grep o define VAULT_SETUP_TOKEN para tener uno estable.

La instalación por defecto usa SQLite y disco local. Quédate con ese montaje para una biblioteca doméstica normal. Postgres y el almacenamiento compatible con S3 están disponibles cuando tengas un motivo concreto para añadirlos.

Conecta una impresora

Abre Printers -> Add printer y elige la interfaz que expone tu máquina:

• Moonraker/Klipper es estable.
• OctoPrint, PrusaLink, Bambu LAN y Elegoo Centauri están en beta.

El soporte va por capacidades. Por ejemplo, Moonraker informa del consumo de filamento medido, mientras que Bambu puede subir y arrancar pero no puede listar los archivos que ya están en la impresora. Consulta la matriz de compatibilidad para ver la columna exacta antes de probar una acción de control.

Empieza por el estado. Después sube un archivo de G-code pequeño y ya validado, sin arranque automático. Prueba a arrancar, pausar, reanudar y cancelar solo cuando la impresora esté despejada y un error no pueda dañar nada.

Añade tu primer modelo

Arrastra a la biblioteca un archivo STL, 3MF, OBJ, STEP/STP, G-code o BGCODE. También puedes usar Upload -> From URL con las páginas compatibles de Printables, MakerWorld y Thingiverse.

PrintStash va a:

• calcular el hash del contenido y detectar si ya existe un archivo idéntico;
• generar una miniatura o la vista previa que corresponda allí donde el formato lo permite;
• extraer la geometría o los metadatos de slicer disponibles;
• crear un registro de modelo capaz de albergar revisiones posteriores e historial de impresión.

Después de la primera importación

• Agrupa los modelos relacionados en colecciones y añade solo las etiquetas por las que vas a buscar.
• Configura Spoolman si ya gestiona tu inventario de filamento.
• Crea y descarga una copia de seguridad probada antes de la primera actualización.
• Añade el hook de OrcaSlicer cuando quieras que los nuevos laminados lleguen solos.

La guía de instalación completa cubre proxies inversos, servicios opcionales y la resolución de problemas del primer arranque en la documentación.