Para NAS y Raspberry Pi
Instala el agente paso a paso
Elige tu sistema, copia cada línea con un clic y pégala. No necesitas saber nada de Docker. Son unos 10 minutos.
Un dispositivo siempre encendido
Un mini PC como un Intel NUC, un NAS (Synology, QNAP, Unraid), una Raspberry Pi 4 o 5 con sistema de 64 bits o un PC con Linux. También vale un PC con Windows o un Mac, pero tiene que quedarse encendido.
En la misma red que tus impresoras
Por cable o por Wi-Fi, conectado al mismo router.
Unos 10 minutos
Cada comando tiene un botón para copiarlo. No tienes que escribir nada a mano.
Tus ajustes
Elige una contraseña para la página web del agente. La ponemos en todos los comandos de abajo, así solo tienes que copiar y pegar. Se queda en esta pestaña del navegador y no se envía a ningún sitio.
Al menos 6 caracteres: letras sin tildes ni ñ, números y - _ . (sin espacios), para que los comandos funcionen en cualquier sistema. Deja 8090, salvo que otro programa ya lo use.
Usa solo letras sin tildes ni ñ, números y - _ ., con al menos 6 caracteres. Mientras tanto, los comandos muestran «TuContrasena».
Elige tu sistema
¿No lo tienes claro? Un mini PC (como un NUC) o una Raspberry Pi con Ubuntu, Debian o Raspberry Pi OS cuenta como «Linux». Si ya gestionas tus contenedores con Portainer, elige Portainer.
Linux: mini PC, NUC, Raspberry Pi, servidor doméstico
Abre un terminal en el dispositivo
Si estás delante del dispositivo, abre la app Terminal. Desde otro ordenador, abre PowerShell (Windows) o Terminal (Mac) y conéctate por SSH. Cambia
userpor tu nombre de usuario en el dispositivo y los números por su dirección IP (la ves en la lista de dispositivos de tu router):La primera vez que te conectes, escribe
yes. Mientras escribes la contraseña no aparece nada en pantalla. Es normal: tú pulsa Intro.Comprueba que Docker está instalado
Pega esto y pulsa Intro:
docker --version¿Ves algo como
Docker version 27.3.1? Entonces pasa al paso 3. ¿Vescommand not found? Entonces instala Docker con esta línea; tarda unos minutos:curl -fsSL https://get.docker.com | sudo shEn una Raspberry Pi, ejecuta también
uname -m. Tiene que saliraarch64. Si salearmv7l, la Pi tiene un sistema de 32 bits: instala primero Raspberry Pi OS (64-bit).Inicia el agente
Pega esta línea. Ya lleva tu contraseña de arriba. Si
sudote pide una contraseña, es la de tu usuario en el dispositivo:sudo docker run -d --name allmyprinters-agent --restart unless-stopped --network host -e AMP_PASSWORD=TuContrasena -e AMP_PORT=8090 -e AMP_LANG=es -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestEl primer inicio descarga el agente y puede tardar uno o dos minutos. Al final verás una línea larga de letras y números. Eso es que ha funcionado.
Comprueba que funciona y busca la dirección
Pega esto:
sudo docker ps --filter name=allmyprinters-agentEn STATUS debería poner
Upy, al cabo de un minuto más o menos,(healthy). Ahora averigua la dirección del dispositivo:hostname -IEl primer número, por ejemplo
192.168.1.50, es la dirección. Sigue abajo con «Abre el agente».
Actualizar más adelante
Ejecuta esta línea. Descarga la versión más reciente y vuelve a iniciar el agente con los mismos ajustes. Tus datos se conservan.
sudo docker pull ghcr.io/nolimitek/allmyprinters-agent:latest && sudo docker rm -f allmyprinters-agent && sudo docker run -d --name allmyprinters-agent --restart unless-stopped --network host -e AMP_PASSWORD=TuContrasena -e AMP_PORT=8090 -e AMP_LANG=es -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestDesinstalar el agente
Detiene y elimina el agente. Tus datos se conservan, así que puedes volver a iniciarlo cuando quieras:
sudo docker rm -f allmyprinters-agentPara borrar también todos sus datos (impresoras, bobinas, historial, biblioteca). No se puede deshacer:
sudo docker volume rm allmyprinters-agentNAS Synology (DSM 7.2 o posterior)
Instala Container Manager
En DSM, abre el Centro de paquetes, busca Container Manager e instálalo. Si tu DSM es anterior a la 7.2, actualízalo primero: antes de la 7.2 el paquete se llamaba Docker y no podía crear proyectos.
Crea una carpeta
Abre File Station. Dentro de la carpeta compartida docker (la creó Container Manager), crea una carpeta nueva llamada
allmyprinters-agent.Crea el proyecto
Abre Container Manager → Proyecto → Crear y rellena:
- Nombre del proyecto:
allmyprinters-agent - Ruta: haz clic en Establecer ruta y elige docker → allmyprinters-agent
- Origen: Crear docker-compose.yml
Pega esto en el cuadro de texto. Ya lleva tu contraseña:
services: allmyprinters-agent: image: ghcr.io/nolimitek/allmyprinters-agent:latest container_name: allmyprinters-agent restart: unless-stopped network_mode: host environment: AMP_PASSWORD: "TuContrasena" AMP_PORT: "8090" AMP_LANG: "es" volumes: - allmyprinters-agent:/data volumes: allmyprinters-agent: name: allmyprinters-agentHaz clic en Siguiente. Deja desactivado el portal web (Web Station), vuelve a hacer clic en Siguiente y luego en Hecho. Container Manager descarga el agente y lo inicia; puede tardar uno o dos minutos.
- Nombre del proyecto:
Comprueba que funciona
En Contenedor,
allmyprinters-agentdebería aparecer En ejecución. La dirección es la misma con la que abres DSM, sin:5000, por ejemplo192.168.1.50. Sigue abajo con «Abre el agente».
Actualizar más adelante
Container Manager busca versiones nuevas más o menos una vez al día. Cuando en Imagen aparezca «Actualización disponible» junto al agente, selecciónalo y elige Actualizar. Container Manager reinicia el agente con la versión nueva y tus datos se conservan.
Desinstalar el agente
Proyecto → allmyprinters-agent → Acción → Detener y después Eliminar. Los datos del agente se quedan en el NAS. Para borrarlos también, ejecuta esto por SSH (no se puede deshacer):
sudo docker volume rm allmyprinters-agentUnraid
Comprueba que Docker está activado
Settings → Docker: «Enable Docker» tiene que estar en Yes. Viene activado de serie.
Abre el terminal
Haz clic en el icono del terminal >_, arriba a la derecha en la interfaz web de Unraid.
Inicia el agente
Pega esta línea y pulsa Intro. Ya lleva tu contraseña:
docker run -d --name allmyprinters-agent --restart always --network host -e AMP_PASSWORD=TuContrasena -e AMP_PORT=8090 -e AMP_LANG=es -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestEl primer inicio descarga el agente. Al final verás una línea larga de letras y números. Eso es que ha funcionado.
Comprueba que funciona
En la pestaña Docker,
allmyprinters-agentaparece ahora como iniciado. Unraid lo marca como contenedor sin plantilla; no pasa nada. La dirección es la de tu servidor Unraid, por ejemplo192.168.1.50. Sigue abajo con «Abre el agente».
Actualizar más adelante
El botón de actualizar de Unraid no sirve para contenedores iniciados de esta forma. Abre el terminal y ejecuta esta línea en su lugar. Tus datos se conservan:
docker pull ghcr.io/nolimitek/allmyprinters-agent:latest && docker rm -f allmyprinters-agent && docker run -d --name allmyprinters-agent --restart always --network host -e AMP_PASSWORD=TuContrasena -e AMP_PORT=8090 -e AMP_LANG=es -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestDesinstalar el agente
Detiene y elimina el agente. Tus datos se conservan:
docker rm -f allmyprinters-agentPara borrar también todos sus datos. No se puede deshacer:
docker volume rm allmyprinters-agentPortainer
Añade un stack
Inicia sesión en Portainer, elige tu entorno (normalmente local) y haz clic en Stacks → Add stack.
Pega el agente
En Name pon
allmyprinters-agenty en Build method elige Web editor. Pega esto en el editor. Ya lleva tu contraseña:services: allmyprinters-agent: image: ghcr.io/nolimitek/allmyprinters-agent:latest container_name: allmyprinters-agent restart: unless-stopped network_mode: host environment: AMP_PASSWORD: "TuContrasena" AMP_PORT: "8090" AMP_LANG: "es" volumes: - allmyprinters-agent:/data volumes: allmyprinters-agent: name: allmyprinters-agentInícialo
Baja hasta el final y haz clic en Deploy the stack. Portainer descarga el agente y lo inicia; puede tardar un minuto.
Comprueba que funciona
En Containers,
allmyprinters-agentdebería mostrar running y, al cabo de un minuto más o menos, healthy. La dirección es la IP del dispositivo en el que funciona Portainer, por ejemplo192.168.1.50. Sigue abajo con «Abre el agente».
Actualizar más adelante
Stacks → allmyprinters-agent → Editor → Update the stack. En el cuadro de diálogo, activa Re-pull image and redeploy y confirma. Tus datos se conservan.
Desinstalar el agente
Stacks → marca allmyprinters-agent → Remove. Los datos del agente se quedan en el volumen allmyprinters-agent. Para borrarlos también, elimina ese volumen en Volumes (no se puede deshacer).
PC con Windows o Mac con Docker Desktop
Docker Desktop no puede dar al agente acceso directo a tu red. El agente funciona, pero su búsqueda no encuentra impresoras de Bambu Lab ni de Elegoo: añádelas con su dirección IP. El ordenador tiene que quedarse encendido y sin entrar en suspensión; si no, el agente también se para.
Instala Docker Desktop
¿Ya lo tienes instalado, por ejemplo para otro contenedor? Entonces sáltate este paso. Si no, descarga Docker Desktop de docker.com, instálalo y ábrelo.
Después, en Docker Desktop, abre Settings → General y activa «Start Docker Desktop when you sign in to your computer», para que el agente vuelva a arrancar cuando reinicies.
Busca la dirección de este ordenador
Windows: abre PowerShell (en el menú Inicio, escribe «PowerShell») y ejecuta
ipconfig. Fíjate en la Dirección IPv4 de tu adaptador de red (Ethernet o Wi-Fi), por ejemplo192.168.1.50.Mac: en Ajustes del Sistema → Red, tu conexión muestra la dirección IP.
Escríbela aquí y el comando del paso 3 se actualiza solo:
Eso no parece una dirección de tu red de casa (p. ej. 192.168.1.50).
Inicia el agente
Pega esta línea en PowerShell (Windows) o en Terminal (Mac) y pulsa Intro. Ya lleva tu contraseña y la dirección:
docker run -d --name allmyprinters-agent --restart unless-stopped -p 8090:8090 -e AMP_PASSWORD=TuContrasena -e AMP_PORT=8090 -e AMP_LANG=es -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestEl primer inicio descarga el agente y puede tardar uno o dos minutos. Si Windows pregunta si Docker puede usar la red, permíteselo en redes privadas.
Comprueba que funciona
En Docker Desktop, en Containers,
allmyprinters-agentdebería aparecer en marcha. En este ordenador puedes abrir el agente enhttp://localhost:8090. Sigue abajo con «Abre el agente».
Actualizar más adelante
Ejecuta esta línea en PowerShell o Terminal. Descarga la versión más reciente y vuelve a iniciar el agente. Tus datos se conservan:
docker pull ghcr.io/nolimitek/allmyprinters-agent:latest; docker rm -f allmyprinters-agent; docker run -d --name allmyprinters-agent --restart unless-stopped -p 8090:8090 -e AMP_PASSWORD=TuContrasena -e AMP_PORT=8090 -e AMP_LANG=es -e AMP_LAN_IP=192.168.1.50 -v allmyprinters-agent:/data ghcr.io/nolimitek/allmyprinters-agent:latestDesinstalar el agente
Detiene y elimina el agente. Tus datos se conservan:
docker rm -f allmyprinters-agentPara borrar también todos sus datos. No se puede deshacer:
docker volume rm allmyprinters-agentHome Assistant OS (app)
Necesitas Home Assistant OS o una instalación Supervised. Si tu Home Assistant funciona en Docker, sigue mejor los pasos de Linux en ese equipo. El campo de contraseña de arriba no hace falta aquí: Home Assistant se encarga del inicio de sesión.
Añade el repositorio
Pulsa el botón. Se abre tu Home Assistant y pregunta si quieres añadir el repositorio de AllMyPrinters. Confirma con Añadir.
Para eso tienes que haber iniciado sesión en Home Assistant en este navegador. Si no, abre la tienda de apps en Home Assistant, ⋮ arriba a la derecha → Repositorios, y añade esta dirección:
https://github.com/nolimitek/ha-allmyprintersInstala la app
Recarga la tienda y abre AllMyPrinters Agent. Pulsa Instalar, luego Iniciar, y activa Mostrar en la barra lateral.
Ábrela
Pulsa AllMyPrinters en la barra lateral. Es el agente, con impresoras, bobinas y ajustes como en la app. Puedes saltarte «Abre el agente» más abajo.
Opcional: entidades y paneles
Para tener impresoras, bobinas, cámara y pausar/cancelar como entidades, instala la integración AllMyPrinters en HACS (repositorio personalizado, la misma dirección de arriba, tipo Integración) y reinicia Home Assistant. Aparece luego en Ajustes → Dispositivos y servicios → Descubierto, solo tienes que confirmarla.
Actualizar más adelante
Home Assistant ofrece las actualizaciones en Ajustes → Actualizaciones, como para cualquier otra app. Tus datos se conservan y forman parte de las copias de seguridad de Home Assistant.
Desinstalar el agente
Ajustes → Apps → AllMyPrinters Agent → Desinstalar. Así también se borran los datos del agente en Home Assistant. Si quieres conservarlos, guarda antes un archivo en el agente en Ajustes → Copia de seguridad.
Después, en cualquier sistema
Abre el agente
En cualquier ordenador, tablet o móvil de tu red de casa, abre en el navegador
http://<address>:8090con la dirección de tu dispositivo, por ejemplohttp://192.168.1.50:8090. Inicia sesión con tu contraseña y guarda la página en favoritos.Conecta la app
En el agente: Más → Ajustes → Vincular dispositivos → Añadir dispositivo. Aparece un código QR que vale durante 10 minutos.
En la app: Más → Ajustes → Conectar con el agente → Escanear código QR.
Luego la app te pregunta qué datos quieres conservar. Si tus impresoras y bobinas ya están en la app, elige Usar los datos de la app: todo se pasa al agente. Necesitas la versión 0.8.1 de la app o posterior.
Añade más impresoras
Las impresoras que aún no están en la app las puedes añadir en el agente, igual que en la app: la búsqueda revisa tu red y la guía de cada marca te dice qué activar en la impresora.
Opcional: acceso desde cualquier lugar
En el agente: Más → Ajustes → Acceso desde cualquier lugar → Activar. Así tus dispositivos vinculados también llegan al agente cuando estás fuera, y en un PC o un iPhone lo abres en allmyprinters.com/web. Sigue desactivado hasta que lo actives, y todo va cifrado de extremo a extremo.
Opcional: Home Assistant
Impresoras, bobinas, cajas de filamento y cámara en Home Assistant: instala la integración AllMyPrinters en HACS (repositorio personalizado
https://github.com/nolimitek/ha-allmyprinters, tipo Integración). Después añádela en Ajustes → Dispositivos y servicios con la dirección del agente y la clave de Más → Ajustes → Home Assistant en el agente.
¿Algo no funciona?
«permission denied»
Pon sudo delante del comando. En nuestros comandos para Linux ya está puesto.
«The container name … is already in use»
El agente ya está instalado. Para iniciarlo con ajustes nuevos (por ejemplo, otra contraseña), quita primero el contenedor antiguo con sudo docker rm -f allmyprinters-agent (en Windows, Mac y Unraid, sin sudo). Tus datos se conservan. Después vuelve a ejecutar el comando de inicio.
«port is already allocated», o el registro dice que el puerto está en uso
Otro programa ya usa el puerto 8090. Escribe otro número arriba, por ejemplo 8091, quita el contenedor (ver arriba) y vuelve a iniciarlo con el comando nuevo. Después abre el agente con el puerto nuevo.
«no matching manifest» o «exec format error»
El dispositivo tiene un sistema de 32 bits y el agente necesita uno de 64 bits. En una Raspberry Pi 3, 4 o 5, instala Raspberry Pi OS (64-bit).
La página no se abre
Comprueba que el agente funciona (último paso de tu sistema) y que usas la dirección y el puerto correctos. El registro suele decirte el motivo: sudo docker logs --tail 30 allmyprinters-agent. Un cortafuegos puede bloquear el puerto: en Ubuntu con ufw, ejecuta sudo ufw allow 8090/tcp. En Synology, permite el puerto en Panel de control → Seguridad → Firewall.
He olvidado la contraseña
Escribe una nueva arriba, quita el contenedor (tus datos se conservan) y vuelve a iniciarlo con el comando nuevo. En Synology o Portainer, cambia la contraseña en el texto compose y actualiza el proyecto o el stack.
La búsqueda no encuentra mi impresora
Añádela con su dirección IP. La encuentras en la pantalla de la impresora o en tu router. En Windows y Mac siempre hace falta para Bambu Lab y Elegoo.
¿Home Assistant OS, Proxmox, TrueNAS, OpenMediaVault, CasaOS?
Home Assistant OS: elige la pestaña Home Assistant de arriba, ahí el agente funciona como app. Proxmox: crea una pequeña VM con Debian o Ubuntu y Docker y sigue dentro los pasos de Linux. TrueNAS SCALE, OpenMediaVault y CasaOS: abre una consola por SSH y sigue los pasos de Linux, o usa Portainer si lo tienes.
¿Sigue sin funcionar?
Toca «Informar de un problema» en la app y cuéntanos qué pasa. Las últimas líneas del registro ayudan mucho: sudo docker logs --tail 30 allmyprinters-agent.