🚀 Setup com Docker Compose

Antes de qualquer docker compose up, confirme que o host tem o que precisa: Docker Engine 24+ e Compose v2. Compose v1 (docker-compose com hífen) está deprecado e não suporta features que o Postiz usa.

Rode os dois comandos abaixo. Se falhar, instale via docs oficiais — nunca via apt install docker.io em distros antigas, vem desatualizado.

# Verificar runtime
docker --version
# Docker version 27.3.1, build ce12230

docker compose version
# Docker Compose version v2.29.7

# Criar diretório de trabalho
mkdir -p ~/postiz && cd ~/postiz
mkdir -p data/postgres data/uploads
touch docker-compose.yml .env .env.example

Conceitos-chave

O stack mínimo do Postiz tem três serviços: a aplicação Postiz (Node + Next), o Postgres (persistência de posts/contas) e o Redis (filas BullMQ que disparam o agendamento). Sem o Redis nada agenda; sem o Postgres nada persiste.

Use volumes nomeados (não bind mounts para dados de banco) e uma network interna para que Postgres/Redis nunca fiquem expostos no host.

# ~/postiz/docker-compose.yml
services:
  postiz:
    image: ghcr.io/gitroomhq/postiz-app:latest
    container_name: postiz
    restart: unless-stopped
    env_file: .env
    ports:
      - "5000:5000"
    volumes:
      - postiz-uploads:/uploads
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    networks: [postiz-net]

  postgres:
    image: postgres:16-alpine
    container_name: postiz-postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: postiz
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: postiz
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postiz"]
      interval: 5s
      timeout: 5s
      retries: 10
    networks: [postiz-net]

  redis:
    image: redis:7-alpine
    container_name: postiz-redis
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      retries: 10
    networks: [postiz-net]

volumes:
  postgres-data:
  postiz-uploads:

networks:
  postiz-net:
    driver: bridge

Conceitos-chave

O Postiz lê configuração via variáveis de ambiente — não tem arquivo de config. As essenciais para subir o stack são URLs (backend/frontend), conexões (Postgres/Redis), o JWT_SECRET e, opcionalmente, storage + Resend para e-mails.

# ~/postiz/.env (NUNCA commitar)
# URLs públicas — ajuste se for usar domínio
MAIN_URL=http://localhost:5000
FRONTEND_URL=http://localhost:5000
NEXT_PUBLIC_BACKEND_URL=http://localhost:5000/api
BACKEND_INTERNAL_URL=http://localhost:3000

# Segredo de assinatura JWT — GERE UM NOVO
JWT_SECRET=cole_aqui_o_resultado_de_openssl_rand_hex_64

# Banco e fila (host = nome do serviço no compose)
POSTGRES_PASSWORD=troque_essa_senha_forte
DATABASE_URL=postgresql://postiz:troque_essa_senha_forte@postgres:5432/postiz
REDIS_URL=redis://redis:6379

# Storage (local p/ começar; S3/R2 em prod)
STORAGE_PROVIDER=local

# E-mail transacional (opcional no dev)
RESEND_API_KEY=re_xxx_opcional_no_dev

Gere o JWT_SECRET com entropia real. Nunca invente uma string "parece aleatória" — o segredo assina os tokens de sessão de TODAS as contas conectadas.

# 64 bytes hex = 512 bits de entropia
openssl rand -hex 64

Conceitos-chave

Com o .env preenchido e o docker-compose.yml salvo, o boot inicial é uma sequência de seis passos. Não pule a verificação de logs — é onde aparecem os erros silenciosos de configuração.

docker compose pull

docker compose up -d

docker compose logs -f postiz

docker compose ps

docker compose ps --format "{{.Name}}\t{{.Status}}"

xdg-open http://localhost:5000

Conceitos-chave

Quase todo problema de setup do Postiz cai em quatro famílias. Antes de googlar o stack trace, leia os logs — eles dizem qual família é.

# Logs de um serviço específico (últimas 100 linhas)
docker compose logs --tail=100 postiz

# Status detalhado de todos os containers
docker compose ps -a

# Entrar no Postgres para inspecionar
docker exec -it postiz-postgres psql -U postiz -d postiz -c "\dt"

# Testar conexão Redis de dentro do container Postiz
docker exec -it postiz sh -c "nc -zv redis 6379"

# Reset completo (APAGA volumes — só em dev!)
docker compose down -v

Conceitos-chave

"Container Up" não é o mesmo que "aplicação funciona". Faça um smoke test de seis pontos antes de declarar vitória.

# Smoke test rápido via CLI
curl -i http://localhost:5000/api/health
# HTTP/1.1 200 OK
# {"status":"ok","db":"up","redis":"up"}

Conceitos-chave