Langflow na VPS: como instalar e criar fluxos de IA
Do contêiner Docker ao Nginx com certificado: como instalar o Langflow num servidor próprio com login ligado, chave secreta definida e a porta 7860 fora da internet.
Por Redação Eleven Host · @robson.direitodigital · 21 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o tutorial: Langflow na VPS: como instalar e criar fluxos de IA Arte: Eleven Host
Langflow na VPS é instalar num servidor próprio a ferramenta visual de código aberto que monta agentes e fluxos de IA ligando blocos, e publicá-la com login, senha forte e HTTPS na frente.
O Langflow executa código no servidor, e o projeto publicou vários alertas críticos em 2026, todos com correção. Em 21/11/2026 a versão mais recente era a 1.13.3: instale a última versão, deixe o login ligado e não abra a porta 7860 direto para a internet.
O que é o Langflow
Pelo README do repositório oficial, o Langflow é uma plataforma para criar e publicar agentes e fluxos de trabalho com IA. A edição é visual, e a ferramenta traz servidores de API e de MCP embutidos, para que cada fluxo possa ser usado como ferramenta por outros aplicativos.
O site do projeto o apresenta como um construtor visual de pouco código e diz que ele trabalha com os principais modelos de linguagem. Entre os logotipos exibidos estão provedores como Anthropic, Mistral e Ollama, e bancos vetoriais como Qdrant e Weaviate.
A licença é a MIT, conforme o arquivo LICENSE do repositório.
Quem chama a IA de verdade
O Langflow organiza o fluxo; quem gera as respostas é o modelo do provedor que você configurar. A documentação chama essas credenciais de chaves de componente: elas autorizam os serviços que os blocos chamam e ficam por conta de quem usa. Elas ficam em variáveis globais ou vêm do ambiente, e o Langflow guarda o valor cifrado ou só uma referência. Apagar a variável no Langflow não revoga a chave: a troca ou exclusão é feita no painel do próprio provedor.
Para quem serve instalar no próprio servidor
Recomendamos considerar o Langflow num servidor quando uma pequena empresa, agência ou equipe de desenvolvimento quer montar um chatbot ou agente que outros sistemas chamam pela API, com os fluxos guardados sob o próprio controle. Uma VPS é um servidor virtual em que você instala o que precisa; o que é e como escolher uma está em O que é servidor VPS: guia simples para iniciantes.
Instalação própria pede um servidor, e a VPS da Eleven Host é um servidor virtual privado. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
Requisitos do Langflow
A página de instalação pede, para o pacote Python, Python de 3.10 a 3.14 e o gerenciador uv. Como mínimo, cita processador de dois núcleos e 2 GB de RAM; como recomendado, processador de vários núcleos e pelo menos 4 GB de RAM.
Além do aplicativo Desktop e do código-fonte, a documentação traz o Docker e o pacote Python. Aqui o caminho principal é o Docker, com a instalação do próprio Docker no servidor feita conforme a documentação dele.
Segurança antes de instalar
A página de segurança do Langflow descreve a ferramenta como um ambiente de desenvolvimento e de execução de código: o editor pode rodar Python com acesso ao processo, aos arquivos e à rede do servidor, e alguns blocos executam código gerado por modelos de IA a partir do que o usuário digita. Ela avisa ainda que o controle de acesso aos fluxos não isola usuários entre si.
A falha CVE-2025-3248, de execução remota de código sem login, afetava versões abaixo da 1.3.0 e foi corrigida na 1.3.0, segundo o alerta do repositório. Em 2026, o projeto publicou outros alertas críticos, de execução de comandos e leitura de arquivos do servidor, o mais recente em 17/11/2026, e todos trazem versão corrigida. Em 21/11/2026, a versão estável mais nova era a 1.13.3, publicada em 17/11/2026.
Recomendamos instalar a versão mais recente e acompanhar os alertas do repositório. A documentação de autenticação avisa para não expor as portas do Langflow na internet sem proteção.
Como preparar as variáveis de ambiente
As imagens Docker oficiais já vêm com o login automático desligado. Com LANGFLOW_AUTO_LOGIN=false, a variável LANGFLOW_SUPERUSER_PASSWORD é obrigatória: sem ela o Langflow não inicia, e ela não pode ser a senha antiga langflow. O usuário padrão é langflow, que pode ser trocado por LANGFLOW_SUPERUSER.
A LANGFLOW_SECRET_KEY cifra dados sensíveis, como as chaves de API, e assina os tokens de login. A documentação recomenda definir a sua em produção e mostra este comando para gerar o valor:
python3 -c "from secrets import token_urlsafe; print(f'LANGFLOW_SECRET_KEY={token_urlsafe(32)}')"
Um exemplo de arquivo /opt/langflow/langflow.env, com opções que a documentação recomenda para produção, para conferir no seu servidor (troque a senha e cole a chave gerada):
LANGFLOW_AUTO_LOGIN=false
LANGFLOW_SUPERUSER_PASSWORD=troque-por-uma-senha-forte
LANGFLOW_SECRET_KEY=cole-aqui-o-valor-gerado
LANGFLOW_CONFIG_DIR=/app/langflow
LANGFLOW_SAVE_DB_IN_CONFIG_DIR=true
LANGFLOW_ENABLE_SIGNUP=false
LANGFLOW_NEW_USER_IS_ACTIVE=false
LANGFLOW_ENABLE_SUPERUSER_CLI=false
LANGFLOW_ACCESS_SECURE=true
LANGFLOW_REFRESH_SECURE=true
A pasta precisa existir antes do arquivo. Um exemplo de comando para criá-la e deixar o arquivo legível só pelo dono:
sudo mkdir -p /opt/langflow
sudo nano /opt/langflow/langflow.env
sudo chmod 600 /opt/langflow/langflow.env
As duas últimas variáveis, segundo a documentação, valem para uso com HTTPS; por isso, o primeiro login fica para depois do certificado. A página de autenticação também recomenda restringir os blocos que executam código quando houver usuários sem confiança, com LANGFLOW_ALLOW_CUSTOM_COMPONENTS=false ou LANGFLOW_BLOCK_CODE_INTERPRETER_COMPONENTS=true.
Como instalar o Langflow com Docker
O início rápido da documentação usa a imagem langflowai/langflow:latest com a porta 7860. Pela própria documentação, sem banco externo e sem LANGFLOW_SAVE_DB_IN_CONFIG_DIR=true, os dados do SQLite ficam dentro do contêiner e se perdem se ele for removido; apontar LANGFLOW_CONFIG_DIR para um volume guarda também a chave secreta e os arquivos enviados.
Um exemplo de comando, com volume nomeado, porta aberta só no próprio servidor (127.0.0.1) e a versão fixa, para conferir no seu servidor; confira antes a tag mais recente publicada da imagem:
sudo docker run -d --name langflow --restart unless-stopped -p 127.0.0.1:7860:7860 -v langflow-data:/app/langflow --env-file /opt/langflow/langflow.env langflowai/langflow:1.13.3
Com a porta presa ao 127.0.0.1, o painel ainda não abre de fora: quem dá acesso é o Nginx, no passo seguinte.
E o PostgreSQL?
Para guardar os dados num PostgreSQL em vez do SQLite, a documentação mostra um exemplo de Docker Compose com dois serviços, o langflow e um postgres, ligados pela variável LANGFLOW_DATABASE_URL, no formato postgresql://langflow:langflow@postgres:5432/langflow. Troque a senha do exemplo antes de usar.
Sem Docker, com uv
No pacote Python, a documentação cria um ambiente com uv venv, instala com uv pip install langflow e inicia com uv run langflow run --env-file .env, no endereço padrão http://127.0.0.1:7860.
Como publicar atrás do Nginx com HTTPS
O guia de Nginx e SSL do Langflow deixa o Langflow ouvindo em 127.0.0.1:7860 e coloca o Nginx na frente. O registro A do domínio precisa apontar para o servidor antes do certificado. Um exemplo de comando para instalar o Nginx no Ubuntu ou Debian, para conferir no seu servidor:
sudo apt update
sudo apt install nginx
Um exemplo de arquivo em /etc/nginx/sites-available/langflow, montado com as diretivas que o guia lista, trocando o domínio pelo seu:
server {
listen 80;
server_name langflow.exemplo.com.br;
client_max_body_size 100M;
location / {
proxy_pass http://127.0.0.1:7860/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 300s;
proxy_buffering off;
}
}
Depois, um exemplo para ativar o site, testar e recarregar:
sudo ln -s /etc/nginx/sites-available/langflow /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Para o certificado, o guia usa o Certbot com o plugin do Nginx, que grava as linhas do certificado na configuração:
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d langflow.exemplo.com.br
Abra então https://langflow.exemplo.com.br e entre com o usuário (por padrão, langflow) e a senha do arquivo de variáveis. O guia diz que, montado assim, o acesso direto à porta 7860 vindo de fora deve falhar, e esse é um bom teste para fazer. Outro exemplo de Nginx está em React na VPS: como publicar seu app com Nginx. Quem prefere não abrir o painel na internet pode deixá-lo acessível só por VPN, como em OpenVPN na VPS: como criar sua VPN passo a passo.
Primeiros passos dentro do Langflow
Recomendamos começar por um fluxo simples: cadastrar a chave do provedor de IA numa variável global, montar um chatbot com poucos blocos e testar no próprio editor antes de chamar o fluxo de fora. Com o login automático desligado, rodar um fluxo pela API exige uma chave de API do Langflow, enviada no cabeçalho x-api-key; ela tem os mesmos privilégios de quem a criou.
Checklist do Langflow na VPS
- versão mais recente instalada e alertas do repositório acompanhados;
- LANGFLOW_AUTO_LOGIN=false e senha forte do superusuário;
- LANGFLOW_SECRET_KEY própria, guardada em lugar privado;
- arquivo de variáveis com chmod 600;
- volume ou PostgreSQL para os dados não ficarem só no contêiner;
- porta 7860 presa ao 127.0.0.1;
- Nginx na frente e certificado emitido com o domínio já apontado;
- cadastro aberto desligado e contas só para pessoas de confiança;
- chaves dos provedores em variáveis globais.
Como atualizar o Langflow
Pela documentação do Langflow sobre Docker, a atualização é baixar a nova tag com docker pull, parar e remover o contêiner antigo e subir outro com o mesmo volume e a tag nova. No Docker Compose, a documentação indica trocar a tag e rodar docker compose pull e docker compose up -d.
A documentação pede backup antes de atualizar e lembra que essa cópia contém a chave secreta, por isso deve ficar em lugar privado: sem a chave original, o Langflow não decifra as credenciais salvas. No pacote Python, o comando é uv pip install langflow -U; a partir da 1.11.x, a documentação traz um procedimento à parte, em ambiente novo e com backup, porque a atualização no lugar pode deixar pacotes incompatíveis.
Uma anotação dos fluxos publicados
Recomendamos anotar o nome de cada fluxo, a data em que entrou no ar e o sistema que o chama.
Pesquise se o nome desejado está livre e registre o domínio na Eleven Host. Buscar domínio
Perguntas frequentes
O Langflow é gratuito?
O código é aberto, sob licença MIT, e pode ser instalado no próprio servidor. Os provedores de IA chamados pelos fluxos têm regras e cobranças próprias: confira com cada um.
Qual é a porta padrão do Langflow?
A 7860. No exemplo acima, ela fica presa ao 127.0.0.1, e o acesso de fora passa pelo Nginx com HTTPS.
Preciso de PostgreSQL?
Não obrigatoriamente. Com o SQLite, guarde os dados num volume; o PostgreSQL entra pela variável LANGFLOW_DATABASE_URL.
A CVE-2025-3248 ainda é um risco?
Ela afetava versões abaixo da 1.3.0 e foi corrigida na 1.3.0. Como houve outros alertas críticos em 2026, use a versão mais recente e acompanhe os alertas do repositório.