Postiz na VPS: agende posts das redes no seu servidor
Postiz v2.26.0 sob AGPL-3.0: requisitos, instalação com Docker Compose, HTTPS com Caddy, apps de cada rede, criptografia de tokens, backup antes de atualizar.
Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Postiz na VPS: agende posts das redes no seu servidor Arte: Eleven Host
Postiz na VPS é um painel próprio para agendar publicações em várias redes sociais, de código aberto, num servidor seu. Veja a licença, os requisitos, a instalação com Docker, o HTTPS, a conexão das redes, o backup e a atualização.
Atualizado em 13/11/2026. Os blocos abaixo são exemplos: confira cada um no seu servidor antes de aplicar. O artigo O que é servidor VPS: guia simples para iniciantes explica o que é uma VPS.
O que é o Postiz
O repositório oficial descreve o Postiz como uma plataforma para agendar, automatizar e analisar conteúdo de redes sociais. Desde a v2.12.0, os posts são agendados pelo Temporal, um dos serviços que sobem junto.
O código está sob a licença AGPL-3.0. Em 13/11/2026, a versão mais recente é a v2.26.0. Recomendamos no mínimo a v2.25.3, que corrige falhas críticas divulgadas em 02/11/2026.
Licença e diferença para a nuvem do Postiz
O README informa que o código está disponível sob a AGPL-3.0 e que o projeto não restringe recursos nem limita a licença.
A diferença prática está nos apps das redes. Na nuvem do Postiz, os apps de desenvolvedor já vêm registrados e aprovados. Na instalação própria, cada rede pede um app de desenvolvedor seu, e o README avisa que a aprovação de plataformas como Meta, YouTube e TikTok pode levar semanas. Atualizações, backup e correções de segurança ficam com quem hospeda. Os recursos de IA pedem chaves de provedor próprias, pagas à parte.
O projeto teve vários alertas críticos em 2026, e a política do repositório diz que só a versão mais recente recebe suporte. O exemplo abaixo fixa a v2.26.0; confira a página de releases do gitroomhq/postiz-app antes de instalar.
Requisitos oficiais e o que sobe junto
A documentação de requisitos traz estes números. Mínimo: 2 GB de RAM, 2 vCPU e 20 GB de disco, para uso leve com tudo no mesmo servidor. Recomendado: 8 GB de RAM, 4 vCPU e 50 GB de disco, mais volume persistente para os uploads. Para pensar em espaço, veja Quanto de disco precisa uma VPS: como calcular.
O compose oficial sobe 8 contêineres: o Postiz, o PostgreSQL e o Redis dele, e o Temporal com Elasticsearch, PostgreSQL próprio, ferramentas de administração e interface web. O backend precisa alcançar as APIs das redes por HTTPS.
Quem prefere um servidor virtual da Eleven Host encontra os planos na loja; confira lá o que cada plano inclui. Ver as VPS
Docker pelo repositório oficial
Os comandos seguem a página do Docker para Ubuntu, que lista as versões 22.04, 24.04 e 26.04 (LTS) e a 26.10; a página do Postiz fala em Ubuntu 24.04. Primeiro o repositório apt. Um exemplo de comandos:
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
Em seguida, o arquivo do repositório. As linhas entre o primeiro e o último comando devem ficar sem recuo, e o EOF final fica sozinho na linha. Um exemplo, a partir da página do Docker:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
Depois, os pacotes e o teste:
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo docker run hello-world
O Docker passa por cima do ufw
A documentação do Docker avisa que as portas publicadas por contêiner ignoram as regras do firewall, como as do ufw. O compose oficial publica a 4007 em todas as interfaces, o que deixaria o Postiz aberto em HTTP. Por isso, mais adiante, a porta fica presa em 127.0.0.1. O Temporal e a interface dele já vêm presos a 127.0.0.1 no compose.
Subdomínio e arquivos do compose
Antes de subir o Postiz, aponte um subdomínio, como postiz.seudominio.com.br, para o IP da VPS, com um registro A no DNS do seu domínio. O HTTPS depende disso. Em seguida, baixe o compose oficial. Um exemplo de comandos; se o git não existir no servidor, instale-o pelo apt antes:
git clone https://github.com/gitroomhq/postiz-docker-compose
cd postiz-docker-compose
A documentação manda baixar o arquivo do repositório em vez de copiar um retrato dele, então o compose não é reproduzido aqui. Gere dois segredos aleatórios, um para o JWT_SECRET e outro para a senha do Postgres. A senha vai dentro da URL do DATABASE_URL, por isso o segundo exemplo usa hexadecimal, sem caracteres como / e +. Um exemplo:
openssl rand -base64 48
openssl rand -hex 24
Abra o docker-compose.yaml e confira estas linhas. Os nomes das variáveis são os oficiais; os valores são sugestões, e vale ler o arquivo inteiro antes de salvar:
- A imagem do Postiz está como
latest. Recomendamos fixar a tag:image: ghcr.io/gitroomhq/postiz-app:v2.26.0. - Na porta do serviço
postiz, troque"4007:5000"por"127.0.0.1:4007:5000". MAIN_URLeFRONTEND_URLviramhttps://postiz.seudominio.com.br, eNEXT_PUBLIC_BACKEND_URLvirahttps://postiz.seudominio.com.br/api. Front e back ficam no mesmo domínio; domínios separados dão erro de estado inválido, segundo a documentação.- Troque o
JWT_SECRET, que traz um texto de exemplo, pelo primeiro segredo gerado. - Troque a senha do Postgres do Postiz,
postiz-password, noPOSTGRES_PASSWORDe dentro doDATABASE_URL, com o mesmo valor nos dois. Faça isso antes da primeira subida: o Postgres só aplica a senha ao criar o volume. - Mude
DISABLE_REGISTRATIONpara'true'. A documentação diz que, comtrue, só um cadastro é permitido e depois a página de cadastro sai do ar.
HTTPS com Caddy
O Postiz usa cookies seguros e espera HTTPS em produção, com um proxy reverso na frente. Dentre as opções da documentação, usamos aqui o Caddy, que para domínio público obtém o certificado do Let's Encrypt sozinho. Instale o Caddy pelo guia oficial do próprio Caddy, deixe as portas 80 e 443 acessíveis para ele e use este Caddyfile, adaptado do exemplo do Postiz; depois de salvar, recarregue o Caddy. Um exemplo:
postiz.seudominio.com.br {
reverse_proxy * localhost:4007
}
O exemplo da documentação aponta para a porta 5000 e traz tls internal, que usa um certificado interno. Com o compose oficial no mesmo servidor, o destino é a 4007, e a linha tls internal fica de fora.
Subir e criar a conta
A documentação usa docker compose up na pasta do repositório. Aqui vai a versão em segundo plano, que sugerimos para não prender o terminal. Um exemplo:
sudo docker compose up -d
Abra https://postiz.seudominio.com.br e crie a sua conta logo em seguida, com o cadastro já fechado pelo DISABLE_REGISTRATION. Sem provedor de e-mail configurado, o Postiz não manda e-mail de ativação e ativa a conta na hora. Com um provedor de e-mail configurado, o novo usuário ativa por um link de vida curta.
Conectar as redes sociais
Dez plataformas, como Bluesky, Lemmy, Nostr e Medium, não pedem configuração no servidor: as credenciais entram no diálogo de canal. A maioria das outras, como X, Facebook, Instagram, LinkedIn e YouTube, pedem um app de desenvolvedor registrado no portal da rede, com as chaves em variáveis. A URL de retorno segue o padrão https://postiz.seudominio.com.br/integrations/social/<provider>.
Dois exemplos de variáveis, no docker-compose.yaml. No X, o app é do tipo Native App com permissão Read and Write; o tipo Web App faz a autenticação falhar com o erro 32. No LinkedIn, é preciso pedir as permissões da Advertising API pelo formulário, senão os tokens não renovam:
X_API_KEY: "sua-chave"
X_API_SECRET: "seu-segredo"
LINKEDIN_CLIENT_ID: "seu-id"
LINKEDIN_CLIENT_SECRET: "seu-segredo"
No Facebook, o app público exige verificação da empresa, e o modo precisa passar de Development para Live; do contrário, os posts só aparecem para você. Depois de pôr as chaves, reinicie com sudo docker compose down e sudo docker compose up -d.
Criptografia dos tokens dos canais
A v2.26.0 trouxe criptografia opcional dos tokens. Sem a variável ENCRYPTION_PROVIDER, nada muda. Com ela, a chave ENCRYPTION_KEY tem 32 bytes em base64, e a documentação mostra openssl rand -base64 32 para gerá-la. Guarde a chave fora da VPS: sem ela, todos os canais precisam ser reconectados. A troca da chave não é suportada, e backups de banco feitos antes de ligar a criptografia ainda têm tokens em claro.
Backup antes de atualizar
Não há procedimento oficial de backup, e o README coloca essa tarefa com quem hospeda. O que segue é uma sugestão, a conferir no seu servidor. Vale guardar o banco do Postiz, o volume de uploads, o docker-compose.yaml com as chaves e a ENCRYPTION_KEY, se houver, tudo fora da VPS. Um exemplo, com o usuário e o banco do compose original:
sudo docker exec postiz-postgres pg_dump -U postiz-user postiz-db-local > postiz-$(date +%F).sql
Para os uploads, um exemplo; o prefixo do volume vem do nome da pasta, e o docker volume ls mostra o nome real:
sudo docker run --rm -v postiz-docker-compose_postiz-uploads:/dados -v "$PWD":/backup alpine tar czf /backup/uploads-$(date +%F).tar.gz -C /dados .
Atualização
Também não há página oficial de atualização. Na imagem Docker, o banco é ajustado na subida, e a v2.26.0 mexe em índices: com tabela de posts muito grande, as escritas esperam, então escolha um horário calmo. Um exemplo de procedimento, depois do backup, na pasta do repositório:
git pull
sudo docker compose pull
sudo docker compose up -d
Troque a tag da imagem no compose antes do docker compose pull. Como o arquivo foi editado, o git pull pode acusar conflito; nesse caso, compare o compose novo com o seu antes de seguir. Depois, confira o login e um post agendado. Com a criptografia ligada, não volte a uma versão anterior. Se a VPS ficar apertada, veja Upgrade de VPS: quando aumentar o plano.
Domínio do painel
O endereço do painel é um subdomínio de um domínio que você já tem ou vai registrar.
Quem ainda não tem domínio pode registrar um na Eleven Host, com centenas de extensões. Buscar domínio
Perguntas frequentes
O Postiz é gratuito na auto-hospedagem?
O código é AGPL-3.0 e o projeto não restringe recursos. Os recursos de IA pedem chaves de provedor próprias, pagas à parte.
Dá para usar o Postiz sem HTTPS?
A documentação diz que os cookies são seguros e que o HTTPS é esperado em produção. A variável NOT_SECURED não deve ser usada em produção.
Qual versão usar?
A mais recente em 13/11/2026 é a v2.26.0; confira a página de releases antes de instalar. Recomendamos no mínimo a v2.25.3.
As redes conectam sozinhas?
Não. Na instalação própria, cada rede que pede app exige um app de desenvolvedor seu, e a aprovação de algumas plataformas pode levar semanas.