Base de Conhecimento

Postiz na VPS: agende posts das redes no seu servidor

  • postiz, agendador de posts, redes sociais, docker, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Postiz na VPS: agende posts das redes no seu servidor

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_URL e FRONTEND_URL viram https://postiz.seudominio.com.br, e NEXT_PUBLIC_BACKEND_URL vira https://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, no POSTGRES_PASSWORD e dentro do DATABASE_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_REGISTRATION para 'true'. A documentação diz que, com true, 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.

Esta resposta lhe foi útil?

Artigos Relacionados