Como Hospedar o Dify por Conta Própria em 2026

Escolher um Servidor

Para a maioria dos usuários que hospedam por conta própria, Hetzner CX22 (€3,79/mês, 2 vCPU, 4GB RAM, 40GB NVMe) é o melhor ponto de partida. Executa o Dify e todos os seus serviços confortavelmente. Os data centers europeus o tornam ideal para conformidade com GDPR.

Para iniciantes que querem um painel mais simples, Hostinger VPS começa a partir de $7,99/mês e inclui mais suporte. Se você precisar de 8GB RAM, o plano KVM 2 deles a $9,99/mês oferece um excelente valor.

Configuração Inicial do Servidor

Conecte ao seu servidor e execute a configuração inicial:

# SSH no seu servidor
ssh root@IP_DO_SEU_SERVIDOR

# Atualizar pacotes
apt update && apt upgrade -y

# Instalar ferramentas essenciais
apt install -y curl wget git ufw

# Criar um usuário não-root
adduser dify
usermod -aG sudo dify

# Copiar chaves SSH para o novo usuário
rsync --archive --chown=dify:dify ~/.ssh /home/dify

# Configurar o firewall UFW
ufw default deny incoming
ufw default allow outgoing
ufw allow 22/tcp comment 'SSH'
ufw allow 80/tcp comment 'HTTP'
ufw allow 443/tcp comment 'HTTPS'
ufw --force enable
ufw status

Agora saia e reconecte como usuário dify para os próximos passos.

Instalar o Docker Engine

Instale o Docker usando o repositório apt oficial — não use a versão snap:

# Instalar pré-requisitos
sudo apt install -y ca-certificates curl gnupg lsb-release

# Adicionar a chave GPG oficial do Docker
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Adicionar o repositório apt do Docker
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Instalar o Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# Adicionar seu usuário ao grupo docker (sem precisar de sudo)
sudo usermod -aG docker $USER
newgrp docker

# Verificar instalação
docker --version

Instalar o Plugin Docker Compose

O plugin Docker Compose está incluído no pacote anterior. Verifique que funciona:

# Verificar a versão do Docker Compose (deve ser v2.x)
docker compose version

# Se não estiver instalado, adicioná-lo manualmente
sudo apt install -y docker-compose-plugin

Clonar e Configurar o Dify

Clone o repositório oficial do Dify e configure seu ambiente:

# Clonar o repositório
git clone https://github.com/langgenius/dify.git
cd dify/docker

# Criar seu arquivo .env a partir do exemplo
cp .env.example .env

# Gerar uma SECRET_KEY segura
openssl rand -base64 42

# Editar o arquivo .env
nano .env

Configurações principais a atualizar em .env:

# OBRIGATÓRIO: Definir uma chave secreta aleatória forte
SECRET_KEY=sua-chave-secreta-gerada-aqui

# Defina seu domínio (usado em e-mails e links)
CONSOLE_URL=https://seu-dominio.com
APP_URL=https://seu-dominio.com

# Alterar a senha padrão do banco de dados
DB_PASSWORD=sua-senha-forte-do-bd

# Alterar a senha padrão do Redis
REDIS_PASSWORD=sua-senha-forte-do-redis

# Opcional: Adicione sua chave API da OpenAI para início rápido
OPENAI_API_KEY=sk-...

Iniciar o Dify

Inicie todos os serviços do Dify com o Docker Compose:

# Iniciar todos os serviços em segundo plano
docker compose up -d

# Verificar que todos os contêineres estão em execução
docker compose ps

# Acompanhar os logs para ver a inicialização (Ctrl+C para sair)
docker compose logs -f

Quando todos os contêineres mostrarem status healthy (leva 1-2 minutos), visite http://IP_DE_TU_SERVIDOR para completar o assistente de configuração do administrador.

Configurar SSL com Nginx

O stack Docker do Dify inclui seu próprio Nginx na porta 80. Para SSL, adicionaremos um Nginx no nível do host como proxy reverso na frente dele. Primeiro, mude a porta do Dify para evitar conflitos:

# Em dify/docker/.env, mude a porta do Nginx
EXPOSE_NGINX_PORT=8080

# Reiniciar para aplicar
docker compose down && docker compose up -d

# Instalar Nginx do host e Certbot
sudo apt install -y nginx certbot python3-certbot-nginx

# Criar config do Nginx para seu domínio
sudo nano /etc/nginx/sites-available/dify

Adicione esta configuração (substitua tu-dominio.com):

server {
    listen 80;
    server_name seu-dominio.com www.seu-dominio.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
        client_max_body_size 100M;
    }
}

# Habilitar e testar
sudo ln -s /etc/nginx/sites-available/dify /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

# Obter certificado SSL (configura automaticamente o Nginx para HTTPS)
sudo certbot --nginx -d seu-dominio.com -d www.seu-dominio.com

Manutenção

Atualizar o Dify — O Dify lança atualizações frequentemente. Atualize sem perder configurações:

cd ~/dify
git pull origin main
cd docker
docker compose pull
docker compose up -d

Backup — Faça backup do seu banco de dados PostgreSQL e dos arquivos enviados:

# Backup do banco de dados
docker compose exec db pg_dump -U postgres dify > backup_$(date +%Y%m%d).sql

# Backup dos arquivos enviados
tar -czf dify_storage_$(date +%Y%m%d).tar.gz ./volumes/app/storage

Monitoramento — Verifique o uso de recursos:

# Uso de recursos dos contêineres
docker stats

# Uso de disco
df -h
docker system df