Agregar una impresora en Linux desde el terminal con lpadmin

La configuración gráfica de impresoras de Ubuntu, Fedora o Mint funciona bien, pero a veces hace falta el terminal: un servidor sin pantalla, una Raspberry Pi, un script para varios equipos o una impresora que la herramienta gráfica no encuentra. Puedes agregar una impresora en Linux desde el terminal con un solo comando de CUPS, lpadmin, y unos pocos auxiliares para comprobar el resultado. Esta guía usa comandos documentados en las páginas de manual de CUPS, así que valen para cualquier distribución que use CUPS.

Cómo se organiza la impresión en Linux

CUPS es el sistema de impresión de casi todos los escritorios Linux. Mantiene una lista de destinos (colas de impresión). Cada destino tiene un nombre, un URI de dispositivo que dice dónde está la impresora y un modelo que dice cómo hablar con ella. El manual de CUPS describe lpadmin como la herramienta que configura colas de impresoras y clases, mientras que lpinfo lista los dispositivos y controladores disponibles.

Las impresoras de red modernas hablan IPP, el Internet Printing Protocol, y pueden describirse a sí mismas ante CUPS. Eso se llama impresión sin controlador, y es la razón de que la mayoría de impresoras actuales no necesiten ningún controlador en Linux.

Paso 1: comprueba CUPS y localiza la impresora

Primero confirma que el planificador funciona:

lpstat -r
lpstat -p -d

El primer comando informa de si el planificador de CUPS está en marcha. El segundo lista las impresoras existentes y la predeterminada, para ver si la impresora ya se agregó sola.

Después busca la dirección de la impresora. Lo más sencillo es imprimir su página de configuración de red desde el panel; nuestra guía para saber la IP de la impresora recoge otros métodos. Reserva esa dirección en el router para que no cambie. También puedes preguntar a CUPS qué ve:

sudo lpinfo -v

Las impresoras de red suelen aparecer con URI ipp://, ipps:// o dnssd://. Las USB aparecen con usb://.

Paso 2: agrega la impresora con IPP Everywhere

La guía de administración de CUPS da este ejemplo para una impresora de red con dirección IP, y dice que el modelo everywhere sirve para casi todas las impresoras de red modernas vendidas desde 2009 aproximadamente:

sudo lpadmin -p Oficina -E -v ipp://192.168.1.20/ipp/print -m everywhere

Qué hace cada parte, según el manual de lpadmin:

• -p Oficina da nombre a la cola. CUPS admite cualquier carácter imprimible salvo espacio, tabulador, / y #, y no distingue mayúsculas.
• -E después de -p activa el destino y hace que acepte trabajos.
• -v fija el URI del dispositivo, aquí IPP hacia la dirección de la impresora.
• -m everywhere consulta a la impresora y crea la cola con sus respuestas.

Puedes añadir una descripción y una ubicación con -D "Láser de arriba" y -L "Despacho".

Paso 3: elige la impresora predeterminada

Dos opciones, según para quién sea:

sudo lpadmin -d Oficina      # predeterminada del servidor para todos
lpoptions -d Oficina         # predeterminada solo para tu cuenta

El manual de lpadmin indica que -d fija el destino predeterminado del servidor. lpoptions -d fija tu predeterminada personal; ejecutado como root se aplica a todos los usuarios mediante /etc/cups/lpoptions.

Paso 4: imprime una prueba

lp -d Oficina /etc/hosts
lpstat -o

lp -d envía un archivo al destino indicado; cualquier archivo de texto pequeño sirve. lpstat -o muestra los trabajos que siguen en cola. Si uno se queda ahí, revisa la dirección de la impresora y que esté encendida. Nuestra guía de la página de prueba explica también cómo imprimir la autoprueba de la propia impresora.

Impresoras antiguas sin IPP Everywhere

Para una impresora que no admite impresión sin controlador, la guía de administración de CUPS muestra un ejemplo con conexión socket directa y uno de los controladores de ejemplo de CUPS:

sudo lpadmin -p LaserVieja -E -v socket://192.168.1.30 -m drv:///sample.drv/laserjet.ppd

lpinfo -m lista los modelos instalados en tu sistema; tu distribución puede ofrecer paquetes con más controladores. Ten en cuenta que el manual de lpadmin dice que los modelos distintos de everywhere están obsoletos y no se admitirán en una versión futura de CUPS, así que comprueba si un firmware más reciente añade IPP Everywhere antes de depender de un controlador viejo.

Cambiar, compartir o quitar una impresora

• Compartirla en la red: sudo lpadmin -p Oficina -o printer-is-shared=true, con el uso compartido activado en CUPS. Nuestra guía del servidor de impresión con Raspberry Pi explica la configuración completa.
• Fijar una opción por defecto: el ejemplo del manual es -o number-up-default=2; el mismo patrón vale para opciones como sides-default=two-sided-long-edge.
• Quitarla: sudo lpadmin -x Oficina. CUPS advierte que se borran los trabajos pendientes de ese destino.

Referencia rápida

Tarea	Comando
¿Funciona CUPS?	lpstat -r
Listar impresoras y predeterminada	lpstat -p -d
Ver el URI de cada impresora	lpstat -v
Listar dispositivos que ve CUPS	sudo lpinfo -v
Agregar una impresora de red sin controlador	sudo lpadmin -p NOMBRE -E -v ipp://DIRECCION/ipp/print -m everywhere
Fijar la predeterminada del sistema	sudo lpadmin -d NOMBRE
Fijar tu predeterminada	lpoptions -d NOMBRE
Imprimir un archivo	lp -d NOMBRE archivo
Ver trabajos en cola	lpstat -o
Quitar una impresora	sudo lpadmin -x NOMBRE

Si la impresora no se agrega

• “Unable to connect” o una pausa larga: comprueba la dirección con ping y que la impresora esté en la misma red que el equipo.
• Ruta de recurso incorrecta: /ipp/print es la ruta habitual de las impresoras IPP Everywhere, pero no la única. Usa el URI que lpinfo -v muestra para la impresora.
• Los trabajos se paran y la impresora queda desactivada: la política de error por defecto es “stop-printer”. Corrige la causa y vuelve a activar la cola con sudo cupsenable NOMBRE.

En macOS y Raspberry Pi

macOS también usa CUPS, así que lpstat, lp y lpadmin están disponibles en el Terminal, aunque la mayoría preferirá los pasos de nuestra guía para agregar una impresora en Mac. En Raspberry Pi OS los comandos son idénticos a los de Debian y Ubuntu. Para la vía gráfica en Ubuntu, consulta cómo agregar una impresora en Ubuntu, y para lo mismo en Windows, cómo agregar una impresora con PowerShell.