Base de Conhecimento

Dify na VPS: como criar apps de IA no seu servidor

  • dify na vps, dify, ia, docker, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Dify na VPS: como criar apps de IA no seu servidor

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_PASSWORD e SANDBOX_API_KEY.
  • Guardei uma cópia do .env fora 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 /install logo 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 .env antes 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.

Esta resposta lhe foi útil?

Artigos Relacionados