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.

Instalação passo a passo

1. 1

   Atualizar o sistema e instalar Docker

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

   bashCopiar

   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.

   bashCopiar

   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.

   .envCopiar

   # /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

   Atenção

   Troque FLOWISE_PASSWORD por uma senha forte antes de iniciar. Sem senha definida, qualquer pessoa com acesso à URL pode usar a plataforma.
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.ymlCopiar

   # /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.

   bashCopiar

   cd /opt/flowise
   docker compose up -d
   
   # Aguardar inicialização (~30s)
   docker compose logs flowise --follow

   Dica

   Aguarde a mensagem confirmando que o servidor está rodando na porta 3000.
6. 6

   Configurar Nginx e SSL

   Configure o reverse proxy e emita o certificado SSL.

   bashCopiar

   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

   Atenção

   Substitua flowise.seudominio.com.br pelo seu subdomínio real.
7. 7

   Configurar firewall e verificar

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

   bashCopiar

   ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp
   ufw --force enable
   
   # Testar
   curl -I https://flowise.seudominio.com.br

   Dica

   Acesse https://flowise.seudominio.com.br. O login solicitará FLOWISE_USERNAME e FLOWISE_PASSWORD definidos no .env.

Troubleshooting

Perguntas frequentes