Docs / Primeiros Passos / Introdução

Introdução

O sh0 é uma plataforma de implantação auto-hospedada que empacota tudo que você precisa em um único binário. Sem manifestos YAML, sem complexidade de orquestração de contêineres -- basta enviar seu código e ele roda.

O que é sh0?

O sh0 é uma plataforma de implantação que você instala no seu próprio servidor. Ele gerencia todo o ciclo de vida das suas aplicações -- desde a construção de código-fonte em contêineres, até a configuração de proxies reversos com SSL automático, até o monitoramento de uptime e gerenciamento de backups.

Diferente de soluções PaaS tradicionais que requerem contas cloud e assinaturas mensais, o sh0 roda inteiramente na infraestrutura que você controla. Um VPS de $5/mês é suficiente para começar, e a plataforma escala com você conforme suas necessidades crescem.

Para quem é o sh0?
Desenvolvedores, agências e equipes que querem a conveniência de uma plataforma gerenciada sem abrir mão do controle sobre sua infraestrutura. Se você já implantou um contêiner Docker manualmente e desejou ter um painel, o sh0 é para você.

Arquitetura de Binário Único

Toda a plataforma sh0 é distribuída como um único binário Rust compilado. Não há dependências de runtime além do Docker -- sem Node.js, sem Python, sem Java, sem bancos de dados externos para provisionar. O painel, servidor de API, gerenciador de proxy reverso, sistema de build e motor de monitoramento estão todos compilados em um executável.

Architecture diagram showing the sh0 binary containing the API server, Svelte dashboard, Caddy proxy manager, Docker orchestrator, and SQLite database

Esta arquitetura significa que a instalação leva segundos, atualizações são uma simples troca de arquivo, e há muito poucos componentes móveis que podem quebrar em produção.

Componentes Principais

ComponenteTecnologiaFunção
Motor PrincipalRust + AxumServidor de API, orquestração de build, lógica de implantação
Proxy ReversoCaddyTerminação HTTPS, Let's Encrypt automático, roteamento
Runtime de ContêineresDocker EngineConstrução de imagens, execução de contêineres, rede
Banco de DadosSQLiteConfiguração, histórico de implantação, armazenamento de métricas
PainelSvelte 5 + SvelteKitInterface web embutida no binário, servida na porta 9000

O que Ele Substitui

O sh0 foi projetado para eliminar a necessidade de juntar múltiplas ferramentas para implantar aplicações no seu próprio servidor. Veja como uma configuração típica de self-hosting se parece antes e depois do sh0:

Sem sh0

  • -- Comandos Docker manuais por aplicação
  • -- Arquivos de configuração Nginx/Traefik para manter
  • -- Cron jobs do Certbot para renovação de SSL
  • -- Pipelines CI/CD personalizados para cada projeto
  • -- Ferramentas separadas de monitoramento e alerta
  • -- Scripts de backup manuais

Com sh0

  • + Um binário, um comando para instalar
  • + Configuração automática de proxy reverso
  • + SSL automático via Let's Encrypt
  • + Git push to deploy, integrado
  • + Monitoramento, métricas e alertas incluídos
  • + Backups agendados para S3/R2

Como Funciona

Quando você executa sh0 serve, o binário inicia vários subsistemas:

  1. Servidor de API -- Um servidor HTTP Axum escuta na porta 9000, servindo tanto o painel quanto a API REST.
  2. Gerenciador do Caddy -- O sh0 lança e gerencia uma instância Caddy como processo filho, atualizando dinamicamente sua configuração conforme você adiciona domínios.
  3. Cliente Docker -- Comunica com o Docker Engine pelo socket Unix para construir imagens, criar contêineres e gerenciar redes.
  4. Workers em Segundo Plano -- Gerencia tarefas agendadas como execução de backups, health checks, renovação de certificados SSL e coleta de métricas.
Diagram showing the request flow: user browser connects to Caddy on port 80/443, which routes to Docker containers, while the dashboard on port 9000 communicates with the sh0 API

Principais Recursos

Git Push to Deploy

Conecte um repositório Git e implante a cada push. Suporta GitHub, GitLab, Bitbucket e qualquer URL Git.

Mais de 170 Templates

Implantação com um clique para stacks populares -- WordPress, PostgreSQL, Redis, Ghost, Plausible e mais.

SSL Automático

Todo domínio recebe um certificado Let's Encrypt gratuito, provisionado e renovado automaticamente pelo Caddy.

Implantações Blue-Green

Implantações sem tempo de inatividade com rollback instantâneo. A versão antiga continua rodando até a nova estar saudável.

Gerenciamento de Banco de Dados

Provisione PostgreSQL, MySQL, MariaDB, MongoDB ou Redis com backups automatizados e injeção de string de conexão.

Multi-Servidor

Escale além de um único servidor adicionando nós remotos. O sh0 implanta contêineres pela sua frota via túneis SSH.

Fluxo de Implantação

Veja o que acontece quando você implanta uma aplicação com o sh0:

Deployment Pipeline
1. Source Code     -- Git clone or image pull
2. Stack Detection -- Auto-detect language and framework
3. Build           -- Generate Dockerfile, build container image
4. Health Check    -- Verify the new container starts and responds
5. Route           -- Update Caddy reverse proxy configuration
6. Live            -- Traffic flows to the new container
7. Cleanup         -- Remove old container (kept for rollback)
Note
O sh0 detecta automaticamente a stack do seu projeto (Node.js, Python, Go, Rust, PHP, Ruby, sites estáticos e mais) e gera um Dockerfile otimizado. Você também pode fornecer seu próprio Dockerfile ou arquivo Docker Compose.

Próximos Passos

Pronto para começar? Siga o guia de instalação para colocar o sh0 em funcionamento no seu servidor em menos de um minuto.