Pular para o conteúdo
EntrarCriar minha VPS

Como instalar o Flowise em uma VPS Ubuntu

O Flowise é uma plataforma visual open-source para criar chatbots e pipelines de IA com interface drag-and-drop. Este guia instala o Flowise com Docker Compose, configura autenticação por usuário e senha, e expõe via HTTPS.

cerca de 20 minjunho/2026 · Ubuntu 24.04 LTS

Antes de começar

VPS mínima
1 vCPU · 2 GB RAM · 20 GB SSD (Runstack Micro ou superior)
Sistema
Ubuntu 24.04 LTS
Também
  • Docker e Docker Compose instalados (veja /tutorial/como-instalar-docker)
  • Subdomínio DNS apontado para o IP da VPS
  • Portas 80 e 443 abertas no firewall

Instalação passo a passo

  1. 1

    Atualizar o sistema e instalar Docker

    Garanta que Docker e Docker Compose estão disponíveis.

    bash
    apt update && apt upgrade -y
curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh
docker --version && docker compose version
  2. 2

    Criar o diretório do projeto

    Crie a pasta de trabalho para o Flowise.

    bash
    mkdir -p /opt/flowise
cd /opt/flowise
  3. 3

    Criar o arquivo .env

    Configure usuário, senha e caminhos de dados. O Flowise usa essas variáveis para autenticação básica.

    .env
    # /opt/flowise/.env
PORT=3000
FLOWISE_USERNAME=admin
FLOWISE_PASSWORD=troque_por_senha_forte_aqui

# Caminhos de dados (mapeados para volume)
DATABASE_PATH=/root/.flowise
SECRETKEY_PATH=/root/.flowise
LOG_PATH=/root/.flowise/logs
BLOB_STORAGE_PATH=/root/.flowise/storage
  4. 4

    Criar o docker-compose.yml

    Esta configuração mapeia o volume de dados para persistência e usa o .env para configuração.

    docker-compose.yml
    # /opt/flowise/docker-compose.yml
services:
  flowise:
    image: flowiseai/flowise:latest
    restart: always
    ports:
      - "127.0.0.1:3000:3000"
    env_file: .env
    volumes:
      - flowise_data:/root/.flowise
    entrypoint: /bin/sh -c "sleep 3; flowise start"

volumes:
  flowise_data:
  5. 5

    Subir o container

    Inicie o Flowise e acompanhe os logs até a confirmação de início.

    bash
    cd /opt/flowise
docker compose up -d

# Aguardar inicialização (~30s)
docker compose logs flowise --follow
  6. 6

    Configurar Nginx e SSL

    Configure o reverse proxy e emita o certificado SSL.

    bash
    apt install -y nginx certbot python3-certbot-nginx

cat > /etc/nginx/sites-available/flowise << 'NGINXEOF'
server {
    listen 80;
    server_name flowise.seudominio.com.br;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name flowise.seudominio.com.br;

    ssl_certificate /etc/letsencrypt/live/flowise.seudominio.com.br/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/flowise.seudominio.com.br/privkey.pem;

    client_max_body_size 50M;

    location / {
        proxy_pass http://127.0.0.1:3000;
        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 3600s;
    }
}
NGINXEOF

ln -s /etc/nginx/sites-available/flowise /etc/nginx/sites-enabled/flowise
nginx -t

certbot --nginx \
  -d flowise.seudominio.com.br \
  --non-interactive \
  --agree-tos \
  --email seu@email.com

systemctl reload nginx
  7. 7

    Configurar firewall e verificar

    Libere apenas as portas necessárias e confirme o acesso.

    bash
    ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp
ufw --force enable

# Testar
curl -I https://flowise.seudominio.com.br

Não quer configurar manualmente?

Implante o Flowise em menos de 5 minutos com a Runstack. Infraestrutura da OPEN Datacenter, com servidores em São Paulo.

Criar minha VPSVer apps prontos

Se der problema

FLOWISE_USERNAME e FLOWISE_PASSWORD devem estar definidos no .env. Sem eles, o Flowise roda sem autenticação. Defina e reinicie o container.

bash
docker compose restart flowise

O volume `flowise_data` precisa estar mapeado para `/root/.flowise`. Verifique o docker-compose.yml e recrie o container se necessário.

Certifique-se de que as credenciais foram reconfiguradas após a importação. Elas não são exportadas, por segurança.

Ajuste as permissões do volume ou use um caminho de host com permissões corretas.

bash
docker compose down
docker volume rm flowise_flowise_data
docker compose up -d

Aumento do proxy_read_timeout no Nginx pode resolver para modelos lentos. O valor padrão já está em 3600s neste guia.

Perguntas frequentes

A versão open-source suporta apenas um usuário administrador via FLOWISE_USERNAME/PASSWORD. Múltiplos usuários e workspaces são recursos da versão Enterprise.

Exporte individualmente via interface (botão Export no flow) ou faça backup do volume Docker: `docker run --rm -v flowise_flowise_data:/data -v $(pwd):/backup alpine tar czf /backup/flowise-backup.tar.gz /data`.

Sim. O Flowise suporta Ollama nativamente. Configure o nó "Ollama" no canvas com a URL `http://host.docker.internal:11434` para conectar ao Ollama rodando no host.

Execute `docker compose pull && docker compose up -d` no diretório /opt/flowise. Faça backup dos dados antes de atualizar versões maiores.

São ferramentas complementares. O Flowise é especializado em pipelines de IA/LLM com interface de chatbot. O n8n é uma plataforma de automação geral com centenas de integrações. Muitos usuários usam os dois juntos: Flowise para lógica de IA e n8n para orquestração de workflows.

Continue lendo