AllMyPrinters

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.

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.

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

  1. 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 user por 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.

  2. 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. ¿Ves command not found? Entonces instala Docker con esta línea; tarda unos minutos:

    curl -fsSL https://get.docker.com | sudo sh

    En una Raspberry Pi, ejecuta también uname -m. Tiene que salir aarch64. Si sale armv7l, la Pi tiene un sistema de 32 bits: instala primero Raspberry Pi OS (64-bit).

  3. Inicia el agente

    Pega esta línea. Ya lleva tu contraseña de arriba. Si sudo te 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:latest

    El 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.

  4. Comprueba que funciona y busca la dirección

    Pega esto:

    sudo docker ps --filter name=allmyprinters-agent

    En STATUS debería poner Up y, al cabo de un minuto más o menos, (healthy). Ahora averigua la dirección del dispositivo:

    hostname -I

    El 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:latest
Desinstalar el agente

Detiene y elimina el agente. Tus datos se conservan, así que puedes volver a iniciarlo cuando quieras:

sudo docker rm -f allmyprinters-agent

Para borrar también todos sus datos (impresoras, bobinas, historial, biblioteca). No se puede deshacer:

sudo docker volume rm allmyprinters-agent

NAS Synology (DSM 7.2 o posterior)

  1. 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.

  2. Crea una carpeta

    Abre File Station. Dentro de la carpeta compartida docker (la creó Container Manager), crea una carpeta nueva llamada allmyprinters-agent.

  3. 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-agent

    Haz 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.

  4. Comprueba que funciona

    En Contenedor, allmyprinters-agent debería aparecer En ejecución. La dirección es la misma con la que abres DSM, sin :5000, por ejemplo 192.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-agent

Unraid

  1. Comprueba que Docker está activado

    Settings → Docker: «Enable Docker» tiene que estar en Yes. Viene activado de serie.

  2. Abre el terminal

    Haz clic en el icono del terminal >_, arriba a la derecha en la interfaz web de Unraid.

  3. 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:latest

    El primer inicio descarga el agente. Al final verás una línea larga de letras y números. Eso es que ha funcionado.

  4. Comprueba que funciona

    En la pestaña Docker, allmyprinters-agent aparece ahora como iniciado. Unraid lo marca como contenedor sin plantilla; no pasa nada. La dirección es la de tu servidor Unraid, por ejemplo 192.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:latest
Desinstalar el agente

Detiene y elimina el agente. Tus datos se conservan:

docker rm -f allmyprinters-agent

Para borrar también todos sus datos. No se puede deshacer:

docker volume rm allmyprinters-agent

Portainer

  1. Añade un stack

    Inicia sesión en Portainer, elige tu entorno (normalmente local) y haz clic en Stacks → Add stack.

  2. Pega el agente

    En Name pon allmyprinters-agent y 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-agent
  3. Inícialo

    Baja hasta el final y haz clic en Deploy the stack. Portainer descarga el agente y lo inicia; puede tardar un minuto.

  4. Comprueba que funciona

    En Containers, allmyprinters-agent deberí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 ejemplo 192.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.

  1. 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.

  2. 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 ejemplo 192.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:

  3. 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:latest

    El 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.

  4. Comprueba que funciona

    En Docker Desktop, en Containers, allmyprinters-agent debería aparecer en marcha. En este ordenador puedes abrir el agente en http://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:latest
Desinstalar el agente

Detiene y elimina el agente. Tus datos se conservan:

docker rm -f allmyprinters-agent

Para borrar también todos sus datos. No se puede deshacer:

docker volume rm allmyprinters-agent

Home 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.

  1. 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.

    Añadir a Home Assistant

    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-allmyprinters
  2. Instala la app

    Recarga la tienda y abre AllMyPrinters Agent. Pulsa Instalar, luego Iniciar, y activa Mostrar en la barra lateral.

  3. Á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.

  4. 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

  1. Abre el agente

    En cualquier ordenador, tablet o móvil de tu red de casa, abre en el navegador http://<address>:8090 con la dirección de tu dispositivo, por ejemplo http://192.168.1.50:8090. Inicia sesión con tu contraseña y guarda la página en favoritos.

  2. 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.

  3. 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.

  4. 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.

  5. 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.