Base de Conhecimento

Formbricks na VPS: formulários e pesquisas no seu servidor

  • formbricks, vps, pesquisas, docker, formulários
  • Usuários acharam útil: 0

Pesquisas de satisfação e formulários com as respostas no seu banco: como instalar o Formbricks 6 com o script oficial ou com Docker Compose, e-mail e atualização.

Por Redação Eleven Host · @robson.direitodigital · 21 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Formbricks na VPS: formulários e pesquisas no seu servidor

Capa da Redação Eleven Host para o guia: Formbricks na VPS: formulários e pesquisas no seu servidor Arte: Eleven Host

Formbricks na VPS é instalar num servidor próprio a plataforma de código aberto de pesquisas, formulários e feedback de clientes, com as respostas guardadas no banco de dados que você administra.

Em 21/11/2026, a versão estável mais recente do Formbricks era a 6.2.2, publicada em 20/11/2026 com correções de segurança. O alerta crítico CVE-2025-59934 afetava versões antes da 4.0.1 e foi corrigido nela: instale a versão mais nova e acompanhe os alertas do repositório.

O que é o Formbricks

O README do repositório oficial apresenta o Formbricks como uma plataforma gratuita e de código aberto de pesquisas e de experiência do cliente, com foco em privacidade. Ele aplica pesquisas dentro de aplicativos, no site, por link e por e-mail, com um editor sem código, modelos prontos de perguntas e segmentação de público.

Ele se integra a Slack, Notion, Zapier e n8n, segundo o README.

Licença e edição gratuita

Pelo arquivo LICENSE, o núcleo do Formbricks está sob a licença AGPLv3, a pasta apps/web/modules/ee tem licença própria e alguns pacotes, como o de pesquisas e os SDKs, são MIT. O README diz que o uso comercial é livre e que versões modificadas precisam ser publicadas sob a mesma AGPLv3.

A página de licença da documentação descreve a Community Edition como gratuita no próprio servidor, sem limite de respostas, pesquisas e usuários, mas com um único workspace.

Outras funções exigem chave de licença Enterprise, segundo a mesma página: tirar a marca do Formbricks das pesquisas, times com papéis de acesso, contatos e segmentos, logs de auditoria, login único por SSO, proteção reCAPTCHA e autenticação em dois fatores. O código delas já vem nas imagens Docker e só é liberado pela chave.

Para quem serve instalar no próprio servidor

Recomendamos considerar o Formbricks num servidor quando uma pequena empresa, loja ou agência quer pesquisa de satisfação, formulário de contato ou coleta de opinião de clientes com os dados sob o próprio controle, e alguém para manter o servidor. 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.

A ferramenta pode ficar numa VPS, 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 e componentes

O guia de Docker pede Docker Engine com o Docker Compose V2 (o comando docker compose), além de curl, openssl e um shell POSIX. O Formbricks usa a porta 3000.

A versão 6 é um conjunto de contêineres. Pela página de componentes, sempre entram o aplicativo, o Hub (API e worker), o Cube (análises), o PostgreSQL com pgvector, o Redis ou Valkey e o SpiceDB (permissões). O PostgreSQL e o Valkey já vêm no pacote, sem instalação à parte.

Versão atual e alertas de segurança

A imagem oficial fica no registro de contêineres do GitHub, como ghcr.io/formbricks/formbricks. Em 21/11/2026, a tag 6.2.2 apontava para a mesma imagem da tag latest. Segundo as notas, a 6.2.2 é uma versão de correções de segurança, entre elas limites para as requisições de autenticação.

A página de alertas do repositório traz um alerta crítico, o CVE-2025-59934: tokens de login não tinham a assinatura conferida, e quem soubesse o identificador de um usuário podia entrar na conta dele ou trocar a senha. Ele afetava versões antes da 4.0.1 e foi corrigido nela. Recomendamos acompanhar os alertas e as versões novas.

Como instalar com o script de um clique

Para Debian 12, Debian 13 e Ubuntu, a documentação oferece um script que instala o Docker (ou reaproveita o que já existe), o PostgreSQL, o SpiceDB, o Hub, o Cube e o Traefik como proxy reverso, com certificado automático do Let's Encrypt quando o HTTPS é ligado. Para pequenas empresas com domínio próprio, recomendamos começar por ele.

Antes de rodar, a documentação pede três coisas:

  • acesso SSH ao servidor, com curl e um usuário com sudo;
  • um domínio ou subdomínio com registro A (e AAAA, se usar IPv6) apontando para o servidor, sem registros antigos apontando para outro lugar;
  • portas 80 e 443 liberadas no grupo de segurança da nuvem, se houver, e no firewall do servidor.

O comando da documentação baixa e executa o instalador; confira-o na página oficial antes de rodar:

curl -fsSL https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/formbricks.sh -o formbricks.sh && chmod +x formbricks.sh && ./formbricks.sh install

O instalador pergunta o domínio, se liga o HTTPS (com o e-mail do certificado e o HSTS) e se configura e-mail e arquivos. Depois, o script tem comandos de manutenção:

./formbricks.sh status

./formbricks.sh logs

./formbricks.sh restart

Atenção: ./formbricks.sh uninstall apaga todos os dados, avisa a documentação.

Como instalar manualmente com Docker Compose

Em outros sistemas, ou para montar o proxy por conta própria, o guia de Docker parte de uma pasta nova, com o Docker e o Compose já instalados conforme a documentação do Docker:

mkdir formbricks-quickstart && cd formbricks-quickstart

mkdir -p cube/schema

curl -fsSL -o docker-compose.yml https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/docker-compose.yml

curl -fsSL -o authzed-postgres-bootstrap.sh https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/authzed-postgres-bootstrap.sh

chmod 700 authzed-postgres-bootstrap.sh

curl -fsSL -o cube/cube.js https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/cube/cube.js

curl -fsSL -o cube/schema/FeedbackRecords.js https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/cube/schema/FeedbackRecords.js

O guia gera as senhas e chaves com openssl rand -hex 32 e grava tudo num arquivo .env, protegido com chmod 600 .env. Um trecho do bloco:

POSTGRES_PASSWORD=$(openssl rand -hex 32)

cat <<EOF > .env

WEBAPP_URL=http://localhost:3000

BETTER_AUTH_URL=http://localhost:3000

POSTGRES_PASSWORD=$POSTGRES_PASSWORD

POSTGRES_PASSWORD_URL_ENCODED=$POSTGRES_PASSWORD

BETTER_AUTH_SECRET=$(openssl rand -hex 32)

ENCRYPTION_KEY=$(openssl rand -hex 32)

CRON_SECRET=$(openssl rand -hex 32)

...

O bloco completo também gera as chaves do Hub, do Cube e do SpiceDB e fecha com EOF; copie-o inteiro da documentação. Num servidor, o guia manda trocar as duas URLs pelo endereço público com HTTPS antes de iniciar, por exemplo https://pesquisa.exemplo.com.br, e não mudar o POSTGRES_PASSWORD depois que o banco criar o volume.

A porta 3000 e a versão fixa

No docker-compose.yml do branch estável, a porta aparece como 3000:3000, aberta em todas as interfaces, e a imagem como ghcr.io/formbricks/formbricks:latest. A página de certificado próprio da documentação publica o Formbricks como 127.0.0.1:3000:3000, para que o acesso de fora passe pelo proxy. Recomendamos fazer o mesmo, com um proxy reverso com HTTPS na frente, e trocar latest pela versão fixa (:6.2.2 em 21/11/2026) nos serviços indicados no guia de atualização.

Depois de conferir as variáveis obrigatórias (listadas na seção seguinte), os comandos do guia para validar, subir e conferir:

docker compose config >/dev/null

docker compose up -d

docker compose ps -a

curl -fsS http://localhost:3000/health

docker compose logs --tail=100 formbricks-migrate hub-migrate spicedb-migrate

Os serviços de migração devem terminar com sucesso, e os demais aparecer como rodando ou saudáveis. Segundo o guia, a página em http://localhost:3000 abre um assistente que cria o primeiro usuário; num servidor, o proxy reverso com HTTPS na frente é um passo posterior, por nossa recomendação. Outro exemplo de contêiner num servidor próprio está em Langflow na VPS: como instalar e criar fluxos de IA.

Variáveis obrigatórias

Entre as obrigatórias, a página de variáveis de ambiente lista:

  • WEBAPP_URL: endereço do aplicativo;
  • BETTER_AUTH_URL: deve ser igual ao WEBAPP_URL, senão todo login é recusado;
  • BETTER_AUTH_SECRET: assina sessões e tokens de convite e verificação, com pelo menos 32 caracteres;
  • ENCRYPTION_KEY: criptografia de dados, com no máximo 32 bytes;
  • CRON_SECRET: segredo das tarefas agendadas, com no máximo 32 bytes;
  • DATABASE_URL e REDIS_URL: conexão com o banco e com o Redis ou Valkey; sem a REDIS_URL, o aplicativo não inicia.

Como configurar o e-mail SMTP

Convites, verificação de e-mail, troca de senha e avisos de respostas dependem do envio de e-mail. Pela página de SMTP, as variáveis entram na seção environment do serviço formbricks no docker-compose.yml, onde já aparecem comentadas; no script de um clique, o instalador pergunta. Um exemplo com os nomes da documentação, para trocar pelos dados do seu provedor:

MAIL_FROM: noreply@exemplo.com.br

MAIL_FROM_NAME: Pesquisas

SMTP_HOST: smtp.seuprovedor.com.br

SMTP_PORT: 587

SMTP_USER: usuario-do-provedor

SMTP_PASSWORD: senha-do-provedor

SMTP_SECURE_ENABLED: 0

SMTP_REQUIRE_TLS: 1

Segundo a documentação, SMTP_SECURE_ENABLED vale 1 para TLS direto, em geral na porta 465, e 0 para STARTTLS ou relay local; SMTP_REQUIRE_TLS em 1 exige STARTTLS, em geral na 587. Um exemplo de comando para aplicar, para conferir no seu servidor: docker compose up -d.

Respostas e dados pessoais

Nome, e-mail e opinião de clientes são dados pessoais. Recomendamos perguntar só o necessário, avisar no formulário para que as respostas serão usadas e restringir quem acessa o painel.

Checklist do Formbricks na VPS

  • versão fixa e atual;
  • subdomínio apontado antes do HTTPS;
  • WEBAPP_URL e BETTER_AUTH_URL com o mesmo endereço https;
  • arquivo .env com chmod 600 e cópia guardada fora do servidor;
  • porta 3000 presa ao 127.0.0.1 atrás do proxy;
  • SMTP configurado e testado com um convite;
  • backup do banco agendado e conferido.

Como atualizar e fazer backup

A página de caminhos de atualização pede subir uma versão minor por vez, sempre para o último patch de cada uma, e não usar latest, que pula essas paradas. No script de um clique, a orientação é fixar a versão de destino antes de rodar ./formbricks.sh update.

No Docker Compose, o guia de atualização troca a imagem para a nova versão nos serviços indicados, baixa com docker compose pull, para os serviços que gravam dados, faz o backup, roda as migrações e sobe tudo com docker compose up -d. Voltar para a imagem antiga não desfaz as migrações do banco, e docker compose down -v apaga os dados.

Para o backup do banco, a documentação mostra:

umask 077

backup_time=$(date -u +%Y%m%dT%H%M%SZ)

docker compose exec -T postgres pg_dump -Fc -U postgres -d formbricks > "formbricks-${backup_time}.dump"

Na versão 6, o mesmo comando com -d spicedb copia o banco de permissões. A documentação pede conferir cada cópia e guardá-las fora da máquina. Recomendamos guardar também o .env, que tem a ENCRYPTION_KEY, num lugar privado e separado.

Um calendário das pesquisas abertas

Recomendamos anotar cada pesquisa publicada, as datas de início e fim e quem recebe as respostas.

Pesquisas com o nome da empresa no endereço partem de um domínio registrado. Buscar domínio

Perguntas frequentes

O Formbricks é gratuito?

A Community Edition é gratuita no próprio servidor, sob a licença AGPLv3, com um workspace. Funções como dois fatores, SSO e times com papéis exigem chave Enterprise.

Qual é a porta padrão do Formbricks?

A 3000. No script de um clique, o acesso de fora passa pelo Traefik.

Preciso instalar PostgreSQL e Redis à parte?

Não no pacote oficial: os dois rodam como contêineres do próprio Compose.

Esta resposta lhe foi útil?

Artigos Relacionados