Formbricks na VPS: formulários e pesquisas no seu servidor
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

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
curle 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_URLeREDIS_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.