Appsmith na VPS: painéis internos da empresa
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

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.