Guia do Developer — Seu primeiro deploy

Suba uma aplicação em container na malha comunitária da ZeroServer e receba uma URL pública HTTPS.

O que você precisa

Uma conta de Developer na ZeroServer.
Uma imagem de container pronta (GHCR, Docker Hub ou outro registry).
O CLI zs instalado.

A ZeroServer nunca faz build do seu código-fonte no MVP. Você traz uma imagem pronta; isso é uma decisão de segurança e simplicidade.

Instale o CLI

curl -fsSL https://raw.githubusercontent.com/zeroserver-cc/zsc-cli/main/install.sh | sh
zs login

O CLI é um binário standalone; não precisa do Node instalado.

Deploy da app de exemplo

git clone https://github.com/zeroserver-cc/demo-apps
cd demo-apps/zsc-app-demo
zs deploy        # lê o zs.yaml do diretório atual

Acompanhe até o status ficar RUNNING:

zs list
# → https://app-xxx.apps.zeroserver.cc

Deploy rápido de uma única imagem

Se quiser só ver o fluxo funcionando:

zs deploy nginx:1.25-alpine -n hello -p 80

Estrutura do zs.yaml

app: minha-api
services:
  - name: db
    image: postgres:16-alpine
    env:
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=app
    volumes:
      - pgdata:/var/lib/postgresql/data
  - name: api
    image: ghcr.io/seu-usuario/minha-api:1.0
    env:
      - DATABASE_URL=postgres://postgres:secret@db:5432/app
    ports: ["3000"]
    dependsOn: [db]
    exposed: true

Serviços na mesma app se enxergam por nome (db:5432).
O serviço com exposed: true recebe a URL pública.
A ZSC não builda imagens; publique no seu registry antes.

Imagens privadas

Você pode usar imagens privadas guardando uma credencial de leitura do registry no portal. A plataforma usa essa credencial apenas para puxar a imagem no deploy.

Comandos úteis

Comando	Descrição
`zs login`	Autentica no backend
`zs deploy`	Sobe ou atualiza a app do diretório atual
`zs list`	Lista apps e status
`zs logs`	Logs em tempo real
`zs stop`	Para a app

Prefere interface web?

O Portal do Developer faz o mesmo deploy pelo wizard. Acesse após fazer login.

Segurança

Seu workload roda em container isolado, sem privilégio, sem acesso ao host do Provedor nem a outros workloads. Toda comunicação entre serviços usa TLS. Seu código-fonte não trafega pela plataforma.

SEU PRIMEIRO DEPLOY

Por que deployar na ZSC?

Próximos passos