​
O que é

server-stack é um ponto de partida opinado pra quem quer rodar o próprio servidor de desenvolvimento num VPS, com tudo em Docker. Clone num host novo, aponte um domínio, rode o bootstrap — stack inteira de pé em minutos. A stack foi desenhada pra ser o suficiente pra um ambiente dev/pessoal ativo, sem escorregar pra complexidade de produção empresarial. Se precisar de mais, é fácil estender (veja Adicionar novo serviço).

​
O que roda

  • Nginx Proxy Manager — reverse proxy com UI, TLS automático (Let’s Encrypt), roteamento por subdomínio.
  • Postgres 16 — banco relacional compartilhado.
  • Redis 7 — cache, filas leves, pub/sub.
  • n8n — plataforma de automação self-hosted (alternativa ao Zapier).
  • Estrutura pronta pra projetos rodarem em cima, reusando a infra.
Cada serviço mora em sua própria pasta dentro de infra/, com docker-compose.yml independente. Nada de compose monolítico.

​
Filosofia

Serviços compartilhados

Um Postgres, um Redis, um n8n para todos os projetos. Reduz uso de RAM e centraliza backup.

Independência por componente

Cada serviço tem seu próprio docker-compose.yml — sobe e desce sem afetar os outros.

Reverse proxy único

NPM cuida de TLS, subdomínios e roteamento HTTP; serviços internos não expõem portas.

Bootstrap automatizado

Um script gera todas as senhas e prepara o ambiente em segundos.

​
Estrutura de pastas

./
├── .gitignore    # ignora .env, dados de volume, certificados, projetos
├── README.md     # entrada do repositório no GitHub
├── infra/        # serviços compartilhados (Docker) — versionado
├── projetos/     # código dos projetos — não versionado aqui (cada projeto = repo próprio)
└── docs/         # esta documentação (Mintlify) — versionado
No host, normalmente em /opt/server/, mas qualquer caminho com permissão de escrita serve.

​
Uma nota sobre os exemplos

Nas páginas de operação, usamos example.com como domínio de exemplo (ou seu-dominio). Troque pelo domínio real que você tiver. Os .env.example também trazem example.com — após o bootstrap, edite infra/*/env com o seu.

​
Próximos passos

1

Conheça a arquitetura

Veja Arquitetura para entender a rede Docker e como os componentes se comunicam.
2

Configure DNS

Configurar DNS é o primeiro passo antes de subir o NPM.
3

Suba tudo do zero

O primeiro deploy cobre a sequência completa.