Dify na VPS: como criar apps de IA no seu servidor
Aprenda a instalar o Dify no seu servidor com Docker Compose, trocar as senhas padrão, criar o administrador, ligar o HTTPS e atualizar com backup.
Por Redação Eleven Host · @robson.direitodigital · 2 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o tutorial: Dify na VPS: como criar apps de IA no seu servidor Arte: Eleven Host
O Dify na VPS é uma plataforma para criar aplicativos com IA, com agentes e suporte a vários modelos. Na sua VPS, ele sobe com Docker Compose a partir do repositório oficial, clonando a tag de uma release.
O que é o Dify e qual é a licença
O README do projeto descreve o Dify como uma plataforma de desenvolvimento de aplicativos com modelos de linguagem (LLM). Segundo o README, ele inclui agentes, RAG e suporte a vários modelos.
A licença é uma licença própria do Dify, que o README descreve como baseada na Apache 2.0, mas com condições adicionais. Isso quer dizer que não é a Apache 2.0 pura. Segundo o arquivo LICENSE, são duas condições:
- não é permitido usar o código-fonte do Dify para operar um ambiente multi-tenant, salvo autorização por escrito da Dify. No contexto do Dify, um tenant corresponde a um workspace;
- ao usar o frontend do Dify, não é permitido remover nem modificar o logo ou as informações de copyright no console ou nos aplicativos.
Ou seja, sem operar ambiente multi-tenant sem autorização e sem remover nem modificar o logo ou o copyright.
Em caso de dúvida sobre uso comercial, consulte um profissional.
Requisitos antes de instalar
A documentação do Dify pede pelo menos 2 núcleos de CPU e 4 GiB de RAM. Esse é o requisito do Dify, não uma descrição dos planos de VPS, então confira na loja o que cada plano inclui antes de escolher. Se você está conhecendo servidores agora, leia o guia de iniciantes sobre servidor VPS.
Em Linux, a documentação pede Docker 19.03 ou superior e Docker Compose 2.24.0 ou superior. Você também precisa do Git. O Dify sobe vários serviços ao mesmo tempo: a documentação lista 7 serviços principais (api, api_websocket, worker, worker_beat, web, plugin_daemon e agent_backend), 8 dependências (weaviate, db_postgres, redis, nginx, ssrf_proxy, agent_ssrf_proxy, sandbox e local_sandbox) e 1 tarefa única, a init_permissions. Nessa última, o status "Exited" é esperado.
Passo a passo da instalação
O comando da documentação descobre a última release pela API do GitHub, usando o curl e o jq. Uma forma mais simples, e uma adaptação nossa, é clonar direto a tag. Na página de releases do projeto, a versão 1.18.0 aparece como a mais recente, publicada em 23 de outubro. Se um dia você precisar de outra versão, troque o número:
git clone --branch 1.18.0 https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
Clone uma tag, e não o branch principal. Os arquivos do branch principal já foram reorganizados, e o .env.example da tag 1.18.0 é o que traz as variáveis descritas neste guia.
A documentação pede um segredo para o agente local. Gere um valor com o comando abaixo e coloque a saída em DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN no .env:
openssl rand -base64 32
Se o clone com o comando da documentação mostrar o erro "Remote branch null not found", use o formato com a versão escrita, como no exemplo acima. Depois, suba tudo e confira:
docker compose up -d
docker compose version
docker compose ps
O docker compose ps mostra o estado de cada serviço.
Está escolhendo uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS
Troque as senhas padrão do .env
O .env.example da tag 1.18.0 traz valores de exemplo. Estes são os principais:
DB_USERNAME=postgres
DB_PASSWORD=difyai123456
REDIS_PASSWORD=difyai123456
SANDBOX_API_KEY=dify-sandbox
SECRET_KEY=
INIT_PASSWORD=
O README da pasta docker avisa que as credenciais que acompanham o projeto servem para um ambiente local. Por isso, antes de abrir o Dify para a internet, recomendamos trocar DB_PASSWORD, REDIS_PASSWORD e SANDBOX_API_KEY por valores seus. O arquivo também traz chaves de exemplo para os plugins (PLUGIN_DAEMON_KEY e PLUGIN_DIFY_INNER_API_KEY), que também merecem ser trocadas.
A SECRET_KEY pode ficar vazia: o comentário do arquivo diz que, vazia, o Dify gera uma chave persistente na pasta de armazenamento. O arquivo .env tem prioridade sobre os arquivos da pasta envs/. Depois de mudar um valor, rode docker compose down e docker compose up -d.
Antes de abrir o Dify para a internet
- Troquei
DB_PASSWORD,REDIS_PASSWORDeSANDBOX_API_KEY. - Guardei uma cópia do
.envfora da VPS. - Criei a conta de administrador (próxima seção).
Criar a conta de administrador
Com os serviços no ar, abra http://IP-DA-VPS/install no navegador, com o IP do seu servidor, e crie a conta de administrador. Depois, entre em http://IP-DA-VPS.
Faça isso logo depois de subir. Se a página /install estiver aberta e o INIT_PASSWORD vazio, quem chegar primeiro pode criar o administrador. Por isso, crie a sua conta antes de divulgar o endereço.
Portas 80, 443 e 5003
O Nginx do Dify publica a porta 80 (HTTP) e a 443 (HTTPS) do servidor. Elas são definidas por EXPOSE_NGINX_PORT e EXPOSE_NGINX_SSL_PORT. A porta 5003, definida por EXPOSE_PLUGIN_DEBUGGING_PORT, é a de depuração de plugins. Ela é publicada pela configuração padrão, e recomendamos não liberá-la no firewall sem necessidade.
Se você também quer hospedar outros sites na mesma VPS, o guia Nginx Proxy Manager: vários sites numa VPS só mostra como organizar vários sites numa VPS.
HTTPS com o certbot do Dify
O repositório inclui um passo a passo com certbot. No .env, você informa o nome dos arquivos do certificado, ativa o desafio e indica o seu domínio e e-mail:
NGINX_SSL_CERT_FILENAME=fullchain.pem
NGINX_SSL_CERT_KEY_FILENAME=privkey.pem
NGINX_ENABLE_CERTBOT_CHALLENGE=true
CERTBOT_DOMAIN=seudominio.exemplo.com
CERTBOT_EMAIL=voce@exemplo.com
Depois rode os dois comandos abaixo, o primeiro para recriar os serviços com o perfil do certbot e o segundo para emitir o certificado:
docker compose --profile certbot up --force-recreate -d
docker compose exec -it certbot /bin/sh /update-cert.sh
Em seguida, coloque NGINX_HTTPS_ENABLED=true no .env e recrie só o Nginx:
docker compose --profile certbot up -d --no-deps --force-recreate nginx
Depois disso, acesse https://seudominio.exemplo.com.
Atualizar o Dify e fazer backup
Antes de atualizar, faça backup. As notas da release 1.18.0 pedem para guardar o banco de dados, os dados do armazenamento de vetores, os arquivos enviados, o armazenamento do agente e os segredos e arquivos de ambiente do deploy. Elas não trazem comandos de backup, então siga as instruções de cada componente.
Segundo as notas dessa release, a atualização segue estes passos:
cd dify/docker
docker compose stop -t -1
git fetch --tags
git checkout 1.18.0
docker compose pull
docker compose up -d
Entre o git checkout e o docker compose pull, as notas mandam mesclar as mudanças de configuração necessárias nos seus arquivos de ambiente. A documentação diz que os passos variam por versão: siga o guia da versão de destino na página de Releases e compare cada .env.example com o seu .env.
O repositório traz o script dify-env-sync.sh, que sincroniza as variáveis novas sem sobrescrever as suas e guarda uma cópia do .env na pasta env-backup/:
chmod +x dify-env-sync.sh
./dify-env-sync.sh
Conectar modelos de IA
A documentação de instalação não diz que o Dify traz um modelo de IA embutido. Como opção para rodar um modelo no seu servidor, o guia Ollama na VPS mostra como instalar o Ollama. Para outra interface de IA no navegador, veja também o Open WebUI na VPS.
Lembre que o Dify já pede 2 CPU e 4 GiB de RAM sozinho. Se você pretende rodar também um modelo na mesma VPS, acompanhe o consumo do servidor.
Checklist do Dify
- Cloneei uma tag de release, não o branch principal.
- Gerei o token do agente local e preenchi no
.env. - Troquei as senhas padrão do banco, do Redis e do sandbox.
- Criei o administrador em
/installlogo depois de subir. - Não liberei a porta 5003 sem necessidade.
- Configurei o HTTPS antes de divulgar o endereço.
- Faço backup do banco, dos arquivos e do
.envantes de atualizar.
Quando vale ter o Dify no seu servidor
Hospedar o Dify por conta própria deixa a instalação no seu servidor. Em troca, você cuida das senhas, do HTTPS, dos backups e de cada atualização.
Quer conhecer a VPS da Eleven Host? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer a VPS
Perguntas frequentes
O Dify é Apache 2.0?
Não é a Apache 2.0 pura. A licença é baseada nela, com duas condições: sem ambiente multi-tenant sem autorização da Dify e sem remover o logo ou o copyright. Em caso de dúvida sobre uso comercial, consulte um profissional.
Quanto de CPU e memória o Dify pede?
A documentação pede pelo menos 2 núcleos de CPU e 4 GiB de RAM.
O Dify já vem com um modelo de IA?
A documentação de instalação não diz isso. O README do projeto cita suporte a vários modelos.
Como crio o primeiro usuário?
Abra /install no endereço do servidor e crie a conta de administrador. Faça isso logo depois de subir.
Como atualizo para outra versão?
Faça backup, siga o guia da versão de destino na página de Releases do projeto e compare o .env.example novo com o seu .env.