Tienes una impresora 3D y todavía caminas hasta ella con un pendrive cada vez que quieres lanzar un G code? OctoPrint elimina ese ritual. Es un servidor web gratuito y de código abierto que corre en un Raspberry Pi: desde ahí cargas archivos, inicias o pausas impresiones, vigilas la temperatura en tiempo real y, si conectas una cámara, ves la impresión en vivo desde el navegador. En esta guía vas a dejar OctoPrint funcionando con la imagen oficial OctoPi, vas a conectar tu impresora por USB, agregar una cámara y dejar instalados los plugins que de verdad valen la pena.
Al terminar vas a saber por qué un Raspberry Pi modesto es suficiente para esta tarea, cómo evitar el error más común de los que recién empiezan (el cable USB que solo carga y no transmite datos) y cómo entrar a tu impresora incluso desde fuera de tu casa.
Qué resuelve OctoPrint
La gracia de OctoPrint es que separa el cerebro de la impresora del computador con el que la controlas. El Raspberry Pi queda enchufado a la impresora de forma permanente y expone una interfaz web a la que entras desde el PC, el celular o la tablet. Estas son las funciones que más vas a usar:
- Subir archivos G code y lanzar, pausar o cancelar impresiones sin tocar la pantalla de la máquina.
- Curvas de temperatura en vivo del hotend y de la cama caliente.
- Stream de la webcam dentro del panel, más videos timelapse automáticos de cada impresión.
- Más de 400 plugins para notificaciones, visualizaciones y automatizaciones.
- Una API para integrar la impresora con Home Assistant, Node RED u otros sistemas.
En la práctica, esto significa dejar la impresora en el taller o la pieza y administrarla desde el sofá, revisando cada cierto rato si el avance va bien.
El hardware que necesitas
OctoPrint no es exigente. Esta es la lista honesta de lo que conviene tener:
| Componente | Recomendación | Detalle |
|---|---|---|
| Raspberry Pi | Pi 4 (2 GB) o Pi 5 | El Pi Zero 2 W funciona, pero lento. El Pi Zero 1 no se recomienda. |
| MicroSD | Mínimo 16 GB, Clase 10 | 32 GB o más si vas a guardar muchos G code. |
| Cable USB | USB-A a USB-B o USB-C | Según el conector de tu impresora. Tiene que ser cable de datos, no solo de carga. |
| Cámara (opcional) | Webcam USB o módulo de cámara para Raspberry | Para el stream en vivo y los timelapse. |
| Fuente | Fuente oficial del Pi | Importante: corriente suficiente, porque el cable a la impresora también consume. |
Un par de notas que evitan dolores de cabeza. La mayoría de las webcam USB se reconocen sin configurar nada, así que cualquier cámara USB decente sirve para empezar. Si prefieres la cámara dedicada del Raspberry, el módulo de cámara se conecta al puerto CSI por cable flex y entrega un stream más limpio. Y sobre la fuente: si la impresora alimenta al Pi por el mismo cable USB, vas a tener cortes; mejor cada uno con su propia energía.
Paso 1: graba la imagen OctoPi en la microSD
La forma más simple de instalar todo es usar la imagen OctoPi, un sistema basado en Raspberry Pi OS que ya trae OctoPrint, el servidor de la webcam y todos los servicios preconfigurados. No tienes que compilar nada.
Abre el Raspberry Pi Imager en tu computador (la descarga es gratuita en raspberrypi.com) y sigue estos pasos:
- Haz clic en Elegir SO y navega a:
Other specific-purpose OS->3D printing->OctoPi->stable. Elige la versión stable, no la nightly. La imagen ya incluye la versión actual de OctoPrint. - Haz clic en el engranaje (o presiona
Ctrl+Shift+X) para preconfigurar el sistema antes de grabar:- Hostname: por ejemplo
octopi, así llegas después comooctopi.local. - WiFi: el SSID y la contraseña de tu red.
- Usuario y contraseña: el usuario por defecto es
pi, pero pon una contraseña segura. - SSH: actívalo, te va a servir para el mantenimiento más adelante.
- Hostname: por ejemplo
- Elige tu microSD como destino y presiona Escribir. En unos 5 a 10 minutos termina.
- Mete la microSD en el Pi, conecta la alimentación y espera 2 o 3 minutos a que arranque por primera vez. Después abre en el navegador:
http://octopi.local.
Si octopi.local no responde, usa la dirección IP del Pi. La encuentras en tu router o con un escaneo de red:
nmap -sn 192.168.x.0/24
Paso 2: el asistente de configuración
La primera vez que abres la interfaz, OctoPrint lanza un asistente que te guía en pocos minutos:
- Cuenta de administrador: define usuario y contraseña para la interfaz web (es independiente de la contraseña del sistema Linux).
- Verificación online: permite que OctoPrint chequee si hay actualizaciones disponibles.
- Perfil de impresora: ingresa el tamaño de la cama y la cantidad de extrusores.
Al terminar aparece el panel principal. Este es el corazón de OctoPrint: a la izquierda el estado y los archivos, a la derecha las pestañas de temperatura, control, visor de G code, terminal y timelapse.
Paso 3: conecta la impresora por USB
Une tu impresora 3D al Raspberry Pi con el cable USB de datos. En OctoPrint, arriba a la izquierda:
- En Serial Port elige
AUTOo selecciona el puerto manualmente (casi siempre/dev/ttyUSB0o/dev/ttyACM0). - Configura la baudrate de tu impresora. En la mayoría de las Prusa, Ender y similares es
115200. - Haz clic en Conectar.
En la pestaña Terminal confirmas que la conexión quedó viva: vas a ver mensajes de temperatura llegando desde la impresora.
La baudrate típica según el modelo:
| Impresora | Baudrate |
|---|---|
| Prusa MK3S+, MK4, XL | 115200 |
| Creality Ender 3, CR-10 | 115200 |
| Anycubic Kobra, Mega | 115200 |
| Impresoras antiguas (Marlin menor a 2.0) | 250000 |
Un detalle para quienes tengan una Bambu Lab: esas impresoras se comunican por MQTT y no por USB. Para integrarlas existe el plugin Bambu Printer, que usa la conexión WiFi en lugar del cable.
Paso 4: configura la cámara
OctoPi ya trae el servidor de la webcam incorporado. Si usas una webcam USB compatible, basta con enchufarla: se detecta de forma automática y la imagen aparece directo en el panel.
Si prefieres el módulo de cámara dedicado del Raspberry, conéctalo por cable flex al puerto CSI del Pi. Luego edita por SSH el archivo de configuración /boot/octopi.txt y deja estas líneas:
camera="raspi"
camera_raspi_options="-fps 30"
Reinicia el Pi y el stream va a correr hasta en 1080p.
Si quieres ajustar la calidad o usar los timelapse, en Settings -> Webcam & Timelapse puedes cambiar la URL del stream y la URL del snapshot. Las URLs por defecto de OctoPi son:
Stream URL: http://octopi.local:8080/?action=stream
Snapshot URL: http://octopi.local:8080/?action=snapshot
Paso 5: los plugins que de verdad valen la pena
Los plugins se instalan desde Settings -> Plugin Manager -> Get More. De las más de 400 opciones, estos cinco son un excelente punto de partida:
- Octolapse: timelapse de nivel profesional. El cabezal se aparta en cada cuadro para que se vea el crecimiento limpio de la pieza.
- OctoEverywhere: acceso remoto seguro por internet sin abrir puertos en el router. Tiene una versión base gratuita.
- PrintTimeGenius: estimación de tiempo restante mucho más precisa que el algoritmo integrado.
- Bed Visualizer: visualiza el nivelado de la cama como un mapa 3D, ideal para verificar que el ABL trabaja bien.
- Cancel Objects: cancela objetos individuales de una impresión con varias piezas sin detener todo el trabajo.
Acceso remoto con OctoEverywhere
Con OctoEverywhere entras a tu impresora desde cualquier lado sin tener que abrir tu router. Después de instalar el plugin:
- Crea una cuenta gratuita en octoeverywhere.com.
- En OctoPrint ve a
Settings->OctoEverywhere->Connect. - Ingresa en la web el código que aparece.
- Listo: recibes una URL personal del tipo
https://tunombre.octoeverywhere.com.
El stream de la webcam también viaja por esa conexión cifrada.
Problemas comunes y cómo resolverlos
La impresora no se detecta (falta /dev/ttyUSB0): revisa que el cable USB sea realmente de datos. Muchos kits de impresoras incluyen cables que solo cargan. Para descartar, ejecuta lsusb por SSH y verifica si la impresora aparece.
No puedes llegar a octopi.local: en Windows a veces falta Bonjour/mDNS. Puedes instalar iTunes (que lo incluye) o usar directo la IP que muestra el router.
La webcam no muestra imagen: comprueba por SSH si el servidor está corriendo con sudo systemctl status webcamd. Si no está activo, levántalo con sudo systemctl start webcamd y deja el valor correcto de camera en /boot/octopi.txt (usb para webcam USB, raspi para el módulo de cámara).
Cortes de impresión por pérdida de USB: es un problema conocido cuando la impresora alimenta al Raspberry Pi por USB. La solución es separar la alimentación (que cada equipo tenga su fuente) o usar un hub USB con energía propia.
Variantes y mejoras
Una vez que OctoPrint esté andando, hay formas de exprimirlo todavía más que no estaban en el plan original:
- Notificaciones a tu celular: combina el plugin OctoEverywhere o uno de Telegram para que la impresora te avise cuando termina, cuando se queda sin filamento o si algo falla. Así no tienes que estar mirando el stream.
- Botón físico de emergencia: el Raspberry Pi tiene pines GPIO libres. Puedes cablear un pulsador y, con un plugin de GPIO, mapearlo a pausar o cancelar la impresión sin abrir el navegador.
- Estación de monitoreo con pantalla: si le sumas una pantalla táctil al Pi y el plugin TouchUI, tienes una consola dedicada al lado de la impresora, sin depender del PC.
- Sensor de fin de filamento: agregando un microswitch en GPIO más un plugin de runout detection, OctoPrint pausa solo la impresión cuando se acaba el material.
Personalización para Chile
En Chile puedes conseguir lo esencial de este proyecto en MechatronicStore:
- MicroSD Kingston Clase 10 (SKU B-450) desde $18.000. Cumple de sobra la recomendación de 16 GB mínimo y Clase 10; las versiones de 64 GB te dejan espacio para guardar muchos archivos G code.
- Módulo de cámara para Raspberry rev 1.3 (SKU M-434) a $7.690 (agotado). Se conecta al puerto CSI del Pi y reemplaza a la webcam USB para el stream y los timelapse.
El Raspberry Pi 5 figura en el catálogo, pero conviene revisar su disponibilidad antes de armar la lista de compra, ya que es la pieza que más rota en stock. Cualquier Raspberry Pi 4 de 2 GB o superior también cumple perfecto para correr OctoPrint. El cable de datos a la impresora depende del conector de tu máquina: confirma si es USB-B o USB-C y, sobre todo, que sea un cable de datos y no uno de solo carga.
Recursos
- Tutorial original (alemán): OctoPrint auf dem Raspberry Pi installieren de Philipp Schweizer en raspberry.tips.
- Raspberry Pi Imager: descarga oficial
- Imagen OctoPi estable: octoprint.org/download
- Documentación de OctoPrint: docs.octoprint.org
Versión chilena con componentes en stock local en MechatronicStore. Guía inspirada en el tutorial de raspberry.tips, reescrita y ampliada con variantes y disponibilidad local.
