Cómo instalar Langflow con Docker paso a paso

Instalar Langflow con Docker es una de las formas más limpias y rápidas de poner en marcha esta herramienta. En esta entrada te contamos cómo hacerlo: desde el comando más básico hasta una configuración robusta con base de datos persistente.

¿Por qué usar Docker para Langflow?

Langflow se ha convertido en una herramienta fundamental para desarrollar flujos de trabajo con IA de forma visual. Su mayor virtud es la facilidad con que conecta prompts, LLMs, APIs y fuentes de datos en un único lienzo interactivo. Es una de las plataformas más potentes e intuitivas tanto para desarrolladores como para equipos de negocios.

Si bien es posible instalar Langflow localmente mediante entorno de Python con pip, desplegarlo mediante Docker es la opción recomendada. Dentro de un contenedor, tanto la app como sus dependencias se ejecutan en un entorno aislado, sin afectar el sistema operativo. Además, esta instalación es la ideal para despliegues de producción, ya que permite integrar bases de datos, volúmenes persistentes y configuraciones avanzadas.

Requisitos para instalar Langflow con Docker

Antes de comenzar a instalar Langflow con Docker, conviene verificar los siguientes elementos en tu equipo o servidor local.

• Docker Engine y Docker Compose instalados y funcionando en tu sistema (Mira el tema Cómo instalar Docker en Linux paso a paso).
• Como recursos mínimos del sistema disponibles, se recomiendan al menos 2 núcleos de CPU y 4 GB de RAM (8 GB o más son esenciales si vas a procesar modelos de lenguaje o incrustaciones de forma local).
• Acceso al puerto 7860, que es el puerto web predeterminado que utiliza Langflow para servir su interfaz de usuario.
• Claves API de los proveedores que utilices en tus flujos (OpenAI, Anthropic, Ollama, Google Gemini, etc.).

Cómo instalar Langflow con Docker: método rápido con Docker Run

Si es la primera vez que vas a utilizar Langflow, la forma más sencilla de instalarlo con Docker es usando el comando docker run. Esta es la opción perfecta para pruebas rápidas o para familiarizarte con la interfaz. Lo primero es abrir la terminal y pegar el comando:

docker run -p 7860:7860 -e LANGFLOW_AUTO_LOGIN=false -e LANGFLOW_SUPERUSER_PASSWORD=TU_PASSWORD langflowai/langflow:latest

No lo ejecutes todavía. Primero, reemplaza TU_PASSWORD por una contraseña segura. Ahora pulsa Enter y el comando descargará la imagen oficial y levantará Langflow en el puerto 7860. Una vez que el proceso termine y el contenedor esté corriendo, puedes abrir Langflow en tu navegador.

Para ello, navega hacia http://localhost:7860/, o usa la dirección IP del dispositivo que usas como servidor local. Por último, inicia sesión con el usuario langflow y usa la contraseña que acabas de configurar.

Este método es ideal para pruebas rápidas, pero no guarda flujos de manera persistente. Si reinicias el contenedor, perderás la información. Por eso, si planeas usar Langflow de forma seria, Docker Compose es la mejor opción.

Cómo instalar Langflow con Docker Compose

Una segunda forma de instalar Langflow con Docker es usando Docker Compose. De esta manera puedes definir y ejecutar varios servicios (Langflow y PostgreSQL) con una sola configuración. Tus flujos, usuarios y configuraciones se guardan de forma persistente en una base de datos externa y permanente. Es la forma recomendada para servidores y VPS.

Paso 1: Clonar el repositorio oficial

El repositorio oficial de Langflow incluye un ejemplo completo de configuraciones de Docker Compose que puedes utilizar como base. Dentro encontrarás un archivo docker-compone-yml listo para usar. Para clonarlo, ejecuta el siguiente comando:

git clone https://github.com/langflow-ai/langflow.git
cd langflow/docker_example

Paso 2: Crear el archivo docker-compose.yml

Si prefieres no clonar el repositorio entero, puedes crear tu propio archivos docker-compose.yml desde cero. Para ello, primero crea un nuevo directorio o carpeta dedicada para organizar los archivos de configuración y datos persistentes de Langflow:

mkdir ~/langflow-compose && cd ~/langflow-compose

Acto seguido, abre tu editor de texto en terminal favorito (como nano o micro) para redactar la configuración:

nano docker-compose.yml

Después, copia y pega la siguiente estructura oficial y optimizada:

services:
langflow:
image: langflowai/langflow:latest
container_name: langflow-app
restart: unless-stopped
ports:
- "7860:7860"
environment:
- LANGFLOW_HOST=0.0.0.0
- LANGFLOW_PORT=7860
- LANGFLOW_AUTO_LOGIN=true
volumes:
- langflow_data:/app/langflow

volumes:
langflow_data:

Paso 3: Inicia los servicios

Finalmente, desde el directorio donde se encuentra tu archivo docker-compose.yml, ejecuta el siguiente comando:

docker compose up -d

La bandera -d inicia los contenedores en segundo plano. Docker Compose descargará las imágenes necesarias y levantará tanto Langflow como POstgreSQL.

Paso 4: Verifica que el servicio está activo y accede a la interfaz web

Como cuarto paso para instalar Langflow con Docker Compose, conviene comprobar el estado de ejecución del contenedor. Para asegurarte de que no haya fallos al arrancar, ejecuta el comando docker compose ps. Deberías ver una salida indicando que langflow-app tiene el estado Up (o running) y que el puerto 7860 está mapeado correctamente.

Finalmente, solo queda acceder a la interfaz web abriendo tu navegado e ingresando a la siguiente dirección local: http://localhost:7860. Si estás instalando en un servidor remoto, reemplaza localhost con la dirección IP de tu servidor. ¡Listo! Verás el lienzo visual de Langflow preparado para empezar a construir tus flujos de trabajo e integrar componentes de inteligencia artificial.

¿Qué incluye esta configuración clonada desde el repositorio oficial? Por un lado, un volumen persistente llamado langflow-data donde se guardan flujos, logs y configuraciones. Por otro, un contenedor PostgreSQL basado en Debian 13 para evitar incompatibilidades de collation. Y también variables de entorno para personalizar la instalación.

Instalar Langflow con Docker: personalización avanzada

Después de instalar Langflow con Docker y que todo esté funcionando, puedes adaptar la instalación a tus necesidades. Por ejemplo, puedes extender la imagen oficial creando un Dockerfile: FROM langflowi/langflow:latest && RUN pip install langchain-community.

Longflow también permite exportar flujos y empaquetarlos dentro de una imagen Docker para despliegues empresariales. Además, gracias a los volúmenes persistentes, actualizar Langflow sin perder datos es simple. Solo tienes que ejecutar los comandos:

docker pull langflowai/langflow:latest
docker compose down
docker compose up

Como puedes ver, instalar Langflow con Docker y mantenerlo funcionado es rápido y sencillo. La combinación de la imagen oficial y la configuración con PostgreSQL te proporciona una base sólida para desarrollar, probar y desplegar tus flujos de IA.

Optar por el método de docker run o la configuración más robusta con Docker Compose ya depende de tus necesidades. Para un usuario serio, siempre se recomienda la segunda opción, ya que asegura la persistencia de los datos y facilita las actualizaciones.