Base de Conhecimento

Directus na VPS: painel e API para seus dados

  • directus, headless cms, api, docker, vps
  • Usuários acharam útil: 0

Directus 12.6.1: licença MSCL e limites do uso grátis, requisitos, instalação com Docker Compose e PostgreSQL, proxy Nginx com HTTPS, atualização, backup e dados pessoais.

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

Arte da Eleven Host: janela de terminal com o título: Directus na VPS: painel e API para seus dados

Capa da Redação Eleven Host para o guia: Directus na VPS: painel e API para seus dados Arte: Eleven Host

Directus na VPS é um jeito de ter, no seu próprio servidor, um painel de administração e uma API sobre um banco de dados SQL. A licença mudou na versão 12: veja o que é grátis, os limites, a instalação com Docker Compose e o proxy com HTTPS.

Atualizado em 12/11/2026. Em 12/11/2026, a versão estável mais nova é a 12.6.1, publicada em 04/11/2026. Os blocos marcados como exemplo não foram executados: confira cada um no seu servidor antes de usar. O site do projeto é directus.com.

O que é o Directus

O Directus, mantido pela Monospace Inc., transforma um banco de dados em CMS headless (um gerenciador de conteúdo que entrega os dados por API, sem site acoplado), em painel administrativo ou em base para aplicativos com interface própria. Você aponta o Directus para um banco SQL e ganha um painel, o Studio, além de APIs REST e GraphQL, autenticação e permissões.

Entre os bancos aceitos pela configuração estão PostgreSQL, MySQL, SQLite, SQL Server, Oracle e CockroachDB. Para entender o que é uma VPS, o guia completo de servidor VPS explica o básico.

Licença: o que é grátis e onde estão os limites

Este é o ponto que mais pesa antes de instalar. Desde a versão 12, o Directus usa a Monospace Sustainable Core License 1.0 (MSCL 1.0), derivada da Fair Core License. Ela é de código disponível, mas não é de código aberto no sentido da OSI, e não é a antiga Business Source License das versões até a 11. Quatro anos depois da publicação de cada versão, ela passa a valer também sob a GPL-3.0.

Sem chave de licença, o Directus roda no tier Core, com limite rígido de 3 assentos (pessoas que entram no Studio) e 25 coleções. Com a Open Innovation Grant, organizações com menos de US$ 5 milhões de receita anual e menos de 50 funcionários têm uso livre completo, com cadastro e chave.

A concessão fica numa página à parte do projeto, directus.com/oig, e não no texto da licença. A elegibilidade considera as pessoas que entram no Studio. Acima desses números, quem usa recursos avançados ou de empresa precisa de licença comercial.

O tier Core também deixa de fora recursos como o login único (SSO, por SAML ou OIDC), que o projeto não oferece nele nem como complemento. Quem passa dos limites ao atualizar para a versão 12 tem 30 dias de carência; depois, as coleções excedentes ficam inativas, sem leitura nem escrita. O projeto afirma que a aplicação dos limites nunca apaga dados.

A licença também não permite oferecer o software a terceiros, cobrando por ele, em concorrência com as ofertas pagas da Monospace. Em caso de dúvida sobre o seu caso, confira com o projeto e com quem cuida do jurídico do negócio.

Para quem serve

Serve a quem já tem, ou vai criar, um banco SQL e quer um painel para a equipe editar os dados e uma API para um site ou aplicativo consumir. Exemplos de uso, sem promessa de resultado: o conteúdo de um blog servido a um site separado ou o cadastro de produtos de uma loja.

Requisitos

O projeto não publica um mínimo oficial de memória, processador ou disco, nem versão mínima de banco. O caminho que o projeto indica é o Docker, já que o Directus é distribuído como imagem. Você precisa de um servidor com o Docker e o plugin Compose já instalados antes dos passos abaixo, de acesso por SSH e, para o endereço definitivo, de um domínio com acesso ao DNS.

Sem um mínimo oficial, o dimensionamento fica por conta de quem instala; o artigo Quanta RAM precisa uma VPS: como calcular a sua ajuda a montar a conta.

Antes do passo a passo, a loja da Eleven Host mostra as VPS disponíveis. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Instalação com Docker Compose

O guia de implantação do projeto parte de um arquivo Compose com três serviços: o banco (PostgreSQL com PostGIS), um cache Redis e o próprio Directus, que publica a porta 8055. Segundo a documentação, o mínimo é configurar um banco e definir o SECRET. A versão abaixo é uma adaptação sem o cache, com a imagem fixada na 12.6.1, já que o projeto recomenda fixar uma versão em produção. Primeiro, uma pasta para o projeto. Um exemplo de comando:

mkdir -p ~/directus && cd ~/directus

Para o SECRET, o projeto pede um valor aleatório e fixo: sem isso, as sessões não sobrevivem a um reinício. Um exemplo de comando que gera uma sequência aleatória, para copiar para o arquivo:

openssl rand -hex 32

Depois, o arquivo docker-compose.yml. Um exemplo, com valores fictícios que você deve trocar, e com a porta publicada só no próprio servidor (127.0.0.1), para o acesso externo passar pelo proxy:

services:

database:

image: postgis/postgis:17-3.5

restart: unless-stopped

volumes:

- ./data/database:/var/lib/postgresql/data

environment:

POSTGRES_USER: directus

POSTGRES_PASSWORD: troque-esta-senha

POSTGRES_DB: directus

directus:

image: directus/directus:12.6.1

restart: unless-stopped

ports:

- 127.0.0.1:8055:8055

depends_on:

- database

volumes:

- ./uploads:/directus/uploads

- ./extensions:/directus/extensions

environment:

SECRET: cole-aqui-a-sequencia-gerada

DB_CLIENT: pg

DB_HOST: database

DB_PORT: 5432

DB_DATABASE: directus

DB_USER: directus

DB_PASSWORD: troque-esta-senha

ADMIN_EMAIL: admin@exemplo.com

ADMIN_PASSWORD: troque-esta-senha-tambem

PUBLIC_URL: https://directus.exemplo.com

A senha do banco precisa ser a mesma nos dois serviços. A PUBLIC_URL deve ser o endereço final que você vai usar: a documentação de licenciamento diz que a licença se vincula a ela no primeiro uso, e mudar depois, sem reaplicar a licença, rebaixa a instância ao Core. Sem volumes, o que muda dentro do contêiner se perde quando ele é parado ou reiniciado.

Depois, suba os serviços e confira a resposta em /server/ping, que não exige autenticação. Um exemplo de comandos:

docker compose up -d

docker compose ps

curl http://127.0.0.1:8055/server/ping

O primeiro administrador sai da tela de apresentação do Studio ou das variáveis ADMIN_EMAIL e ADMIN_PASSWORD. O painel só abre de fora pelo endereço do proxy, na próxima seção, porque a porta 8055 está publicada apenas no próprio servidor. Recomendamos trocar essa senha no painel, por uma forte, depois do primeiro acesso.

Proxy reverso com Nginx e HTTPS

A página de implantação não cobre proxy reverso. O tutorial oficial para Ubuntu usa o Nginx na frente, com um bloco server na porta 80 que encaminha para http://localhost:8055 e inclui os cabeçalhos de WebSocket. Esse tutorial usa a versão 11 e libera a porta 8055 no firewall; no exemplo abaixo ela fica só no 127.0.0.1. O Nginx precisa estar instalado no servidor antes (no Ubuntu, pelo apt). Um exemplo de bloco para o Nginx, com domínio fictício, a conferir no seu servidor:

server {

listen 80;

server_name directus.exemplo.com;

client_max_body_size 50m;

location / {

proxy_pass http://127.0.0.1:8055;

proxy_set_header Host $host;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

}

}

Aponte o DNS do domínio para o IP da VPS. Para domínios registrados conosco, há DNS gerenciado grátis na rede da Cloudflare (painel na área do cliente). O Nginx precisa estar instalado no servidor (o tutorial oficial parte de um Ubuntu). Depois de salvar o bloco como site ativo do Nginx, teste a sintaxe com sudo nginx -t e recarregue o serviço.

O tutorial oficial emite o certificado com o Certbot. O artigo Certbot na VPS: SSL grátis do Let's Encrypt no Nginx detalha o passo a passo. A documentação de segurança informa que os cookies SESSION_COOKIE_SECURE e REFRESH_TOKEN_COOKIE_SECURE vêm desligados por padrão; com o HTTPS ativo, recomendamos ligá-los.

Há uma mudança da versão 12 que importa atrás de proxy: o padrão da variável IP_TRUST_PROXY passou de verdadeiro para falso. Quem depende do IP real do visitante precisa definir essa variável de forma explícita; sem isso, o Directus enxerga o IP do proxy, o que afeta registros e o limitador de requisições. O limitador de requisições (RATE_LIMITER_ENABLED) também vem desligado.

Atualização e backup

Segundo o guia de atualização, com Docker troca-se a etiqueta da imagem no docker-compose.yml, e as migrações do banco são automáticas. O guia pede ler antes a lista de mudanças que quebram compatibilidade. A atualização migra o banco automaticamente, mas isso não é uma cópia de segurança: recomendamos fazer a sua antes de atualizar.

O projeto não publica um guia oficial de backup. A visão geral apenas lista backup entre as partes que quem hospeda por conta própria precisa planejar. Recomendamos copiar três coisas: o banco, as pastas uploads e extensions e o arquivo do Compose, com as variáveis. Um exemplo, a executar na pasta do projeto e a conferir no seu servidor, com a pasta de cópias fictícia:

mkdir -p ~/copias

docker compose exec -T database pg_dump -U directus directus > ~/copias/directus.sql

tar czf ~/copias/directus-arquivos.tar.gz uploads extensions docker-compose.yml

Uma cópia guardada só no mesmo servidor pode se perder junto com ele. O artigo Backup da VPS: como fazer cópia automática trata da cópia automática da VPS.

Instalação sem Docker

A instalação pelos pacotes npm existe, com Node.js 26 ou mais novo. As imagens do Docker já usam essa versão do Node.js.

Dados pessoais no painel

Se o Directus for guardar nomes, e-mails ou outros dados de clientes, a LGPD, a lei brasileira de proteção de dados, passa a valer para esse conteúdo. Um software não garante conformidade sozinho. Recomendamos limitar quem tem acesso ao Studio, usar HTTPS, manter a cópia de segurança fora do servidor e tratar o tema com quem cuida do jurídico do negócio.

Escolher o tamanho do servidor

Com o banco, o proxy e a rotina de cópias definidos, falta decidir onde tudo isso vai ficar.

Na etapa de escolher o servidor, a loja da Eleven Host exibe as VPS e seus planos. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

O Directus é gratuito?

Há duas formas gratuitas. O tier Core está disponível a todos, sem licença comercial, com 3 assentos e 25 coleções. Já a Open Innovation Grant libera o uso completo para organizações com menos de US$ 5 milhões de receita anual e menos de 50 funcionários, com cadastro e chave.

O Directus é de código aberto?

Não no sentido tradicional. A licença é a MSCL 1.0, de código disponível, e cada versão passa a valer também sob a GPL-3.0 quatro anos depois de publicada.

A atualização faz backup?

Ela migra o banco sozinha, mas isso não substitui a cópia de segurança; recomendamos fazê-la antes de atualizar.

Esta resposta lhe foi útil?

Artigos Relacionados