Base de Conhecimento

Appsmith na VPS: painéis internos da empresa

  • appsmith, painel interno, low-code, docker, vps
  • Usuários acharam útil: 0

Appsmith Community v2.7.0 sob Apache 2.0: requisitos, instalação com Docker Compose, domínio com HTTPS, backup antes de atualizar, telemetria e dados de clientes.

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

Arte da Eleven Host: janela de terminal com o título: Appsmith na VPS: painéis internos da empresa

Capa da Redação Eleven Host para o guia: Appsmith na VPS: painéis internos da empresa Arte: Eleven Host

Com o Appsmith na VPS, a empresa monta painéis de administração e telas internas ligadas a bancos de dados e APIs, com uma plataforma de código aberto num servidor seu. Veja a licença, os requisitos, a instalação com Docker, o HTTPS, o backup e a atualização.

Atualizado em 13/11/2026. Confira cada exemplo de comando no seu servidor antes de usar. O artigo O que é servidor VPS: guia simples para iniciantes explica o que é uma VPS.

O que é o Appsmith

O repositório oficial descreve o Appsmith como uma plataforma para criar painéis de administração, ferramentas internas e dashboards, que se integra a mais de 25 bancos de dados e a APIs. Entre os exemplos de uso estão a visão completa do cliente e a automação de TI. Ele conversa com MySQL, PostgreSQL e APIs REST.

A edição Community é de código aberto, sob a licença Apache 2.0. Na data deste guia, a versão estável é a v2.7.0, de 12/11/2026, e é a tag fixada no exemplo de compose.

Licença, edições e versão

A Community é a edição de código aberto e gratuita. A documentação de instalação recomenda a imagem comercial appsmith-ee, que tem plano gratuito, e manda trocar o nome para appsmith-ce, com a mesma tag, para usar a Community. Aqui a escolha é a appsmith-ce.

SSO por SAML ou OIDC e papéis de acesso personalizados são recursos de plano pago, e o fabricante define os valores. Em setembro e outubro de 2026 o projeto divulgou vários alertas de segurança de severidade alta e crítica. Recomendamos usar a v2.7.0 ou uma mais nova e conferir a página de avisos de segurança do repositório github.com/appsmithorg/appsmith.

Requisitos oficiais

A documentação pede Docker 20.10.7 ou mais novo e Docker Compose 1.29.2 ou mais novo. Para o modo tudo-em-um, com MongoDB, Redis e PostgreSQL dentro do contêiner, pede pelo menos 8 GB de RAM no host. Como ponto de partida, a documentação indica 2 vCPU e 8 GB de memória, para teste, avaliação e pouco tráfego, e diz que isso não garante capacidade para uso intenso. Ela pede ao menos 10 a 15 GB livres de disco.

O servidor precisa de saída para cs.appsmith.com, de onde o Docker baixa as imagens. Os exemplos abaixo partem de um servidor com Ubuntu, que a documentação do Docker lista nas versões 22.04, 24.04 e 26.04 (LTS).

Servidores VPS à venda na Eleven Host; confira na loja o que cada plano inclui. Ver as VPS

Docker pelo repositório oficial

Primeiro o Docker Engine, pelo repositório da documentação do Docker. Um exemplo de comandos, a partir da página do Docker para Ubuntu; o arquivo docker.sources deve ser criado com o bloco que aparece nela:

sudo apt update

sudo apt install ca-certificates curl

sudo install -m 0755 -d /etc/apt/keyrings

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

sudo chmod a+r /etc/apt/keyrings/docker.asc

Depois de criar o /etc/apt/sources.list.d/docker.sources, instale os pacotes e teste:

sudo apt update

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo docker run hello-world

Pasta e compose

A documentação manda criar a pasta appsmith e entrar nela. Um exemplo de comandos:

mkdir -p ~/appsmith

cd ~/appsmith

nano docker-compose.yml

O docker-compose.yml da documentação, com a troca para a Community e a tag fixa. O YAML depende dos espaços no começo de cada linha: se o recuo se perder ao copiar, refaça-o como no arquivo da documentação.

version: "3"

services:

appsmith:

image: index.docker.io/appsmith/appsmith-ce:v2.7.0

container_name: appsmith

ports:

- "80:80"

- "443:443"

volumes:

- ./stacks:/appsmith-stacks

restart: unless-stopped

A documentação recomenda fixar a tag em produção, para evitar atualização inesperada quando o contêiner for recriado, e diz que sem tag o Docker usa a latest. O volume ./stacks guarda dados e configuração.

Nos exemplos oficiais aparece docker-compose; no Docker atual, instalado com o plugin acima, o comando é docker compose, com espaço. Um exemplo, na pasta ~/appsmith:

sudo docker compose up -d

O Docker passa por cima do ufw

A documentação do Docker avisa que portas publicadas por contêiner ignoram as regras do firewall, como as do ufw. As portas 80 e 443 do compose ficam acessíveis mesmo com regras do ufw que as bloqueiem, então não conte com o ufw para protegê-las.

Domínio e HTTPS antes do primeiro acesso

A instalação pode levar até 5 minutos para subir. O primeiro acesso cria a conta de administrador, e esse passo fica aberto a quem chegar à página antes de você. Com o contêiner no ar e o domínio ainda não configurado, o IP da VPS já responde na porta 80, então não abra nem divulgue esse endereço: configure primeiro o domínio e o HTTPS.

Aponte um subdomínio, como painel.exemplo.com.br, para o IP da VPS, de preferência antes de subir o contêiner, e espere o DNS valer. A documentação pede um domínio ou subdomínio e as portas 80 e 443 abertas; para o Let's Encrypt, o DNS precisa apontar para o servidor antes do reinício. O certificado do Let's Encrypt, recomendado por ela, é gerado pelo próprio Appsmith, que usa o Caddy interno, sem Nginx nem Certbot. Segundo a documentação, o Let's Encrypt não emite certificado para domínio efêmero.

A variável é APPSMITH_CUSTOM_DOMAIN, só com o nome, sem http:// ou https://. Um exemplo: o arquivo ~/appsmith/stacks/configuration/docker.env é criado pela instalação; se ele ainda não existir, aguarde a subida e confira de novo. A pasta stacks é criada pelo Docker e talvez exija sudo para editar o arquivo. Acrescente a linha abaixo e recrie o contêiner:

APPSMITH_CUSTOM_DOMAIN=painel.exemplo.com.br

sudo docker compose rm -fsv appsmith

sudo docker compose up -d

Dá para usar também o certificado próprio, com fullchain.pem e privkey.pem sem senha, copiados para ./stacks/ssl/. Desde a v2.6.0, o docker.env só aceita valores literais, sem expressões de shell. Com o HTTPS ativo, abra https://painel.exemplo.com.br e crie o administrador.

A documentação recomenda também desligar o cadastro aberto e configurar o SMTP. Depois de criar o administrador, a variável APPSMITH_SIGNUP_DISABLED=true, no docker.env, barra o cadastro de quem não foi convidado; recrie o contêiner para valer.

Backup antes de atualizar

Na pasta do docker-compose.yml, o backup oficial pede uma senha e cifra o arquivo. Sem a senha, o restore não funciona. Um exemplo:

sudo docker compose exec -it appsmith appsmithctl backup

O arquivo appsmith-backup-...tar.gz.enc fica em ./stacks/data/backup/ e inclui o banco interno, o docker.env e os dados do Git. Guarde fora do servidor uma cópia do backup e do docker.env, e anote a senha do backup e os valores de APPSMITH_ENCRYPTION_PASSWORD e APPSMITH_ENCRYPTION_SALT em lugar separado do arquivo. Ao restaurar com a chave de criptografia errada, as credenciais de banco salvas ficam ilegíveis. Backup e restore pedem pelo menos 2 GB livres.

Rodado sem terminal, como no cron do host, o backup sai sem criptografia, com o banco em texto puro. Para agendar, a documentação traz a variável APPSMITH_BACKUP_CRON_EXPRESSION, e APPSMITH_BACKUP_ARCHIVE_LIMIT define quantos arquivos ficam (padrão 4).

Para restaurar, copie o arquivo para a pasta de backup do contêiner e rode o restore, que pede a senha e reinicia o servidor. Ele sobrescreve os dados do destino. Um exemplo:

sudo docker cp appsmith-backup-TIMESTAMP.tar.gz.enc appsmith:/appsmith-stacks/data/backup/

sudo docker compose exec -it appsmith appsmithctl restore

Atualização

A documentação sugere atualizar a cada duas semanas ou quando sair correção de segurança, testando antes num ambiente separado. Faça o backup, troque a tag da imagem no compose e rode o comando de atualização, na pasta da instalação. Um exemplo, a partir do comando da documentação:

sudo docker compose pull && sudo docker compose rm -fsv appsmith && sudo docker compose up -d

Se falhar, a volta é pelo restore. A v2.6.0 pede ainda que opções de JVM saiam do docker.env e vão para a configuração do Compose antes de subir de versão.

Telemetria e dados de clientes

A telemetria vem ligada. Para desligar, há o campo Share anonymous usage data nas configurações de administrador ou a variável APPSMITH_DISABLE_TELEMETRY=true no docker.env. Mesmo assim o servidor envia um sinal a cada 2 horas. A documentação diz que o Appsmith não captura dados retornados por APIs ou bancos.

Painéis que mostram dados de clientes pedem cuidado com a LGPD: recomendamos dar acesso só a quem precisa, manter o HTTPS e as atualizações em dia e proteger as cópias de backup. Cumprir a LGPD depende dos processos da empresa e cabe ao jurídico avaliar.

Bancos como origem de dados

O Appsmith se conecta ao MySQL (5.5 a 8.0) e ao PostgreSQL, na porta 5432 por padrão. Num banco externo, uma possibilidade é liberar no banco o IP público da sua VPS, e não os IPs da nuvem do Appsmith que a documentação cita; confira as regras de acesso no seu banco.

Para decidir entre planilha e banco, veja Planilha ou banco de dados: quando trocar e Quando usar banco de dados gerenciado: como decidir. Outra opção para painel e API sobre dados está em Directus na VPS: painel e API para seus dados.

O subdomínio do painel sai de um domínio registrado, e a busca de nomes e extensões pode ser feita na Eleven Host. Buscar domínio

Perguntas frequentes

O Appsmith é gratuito?

A Community é de código aberto, sob a Apache 2.0. Recursos como SSO e papéis personalizados são de plano pago.

Quanta memória o Appsmith pede?

Pelo menos 8 GB de RAM no host para o modo tudo-em-um, segundo a documentação.

Preciso de Nginx para o HTTPS?

A documentação de domínio personalizado usa o Caddy interno e o Let's Encrypt, sem proxy externo.

Qual versão usar?

Na data deste guia, a v2.7.0, de 12/11/2026, ou uma mais nova.

Esta resposta lhe foi útil?

Artigos Relacionados