Docs/ CLI/ Instalação

Instalação

Instale, autentique e configure o CLI sh0.

Script de Instalação

A forma recomendada de instalar. O script detecta seu SO e arquitetura, baixa o binário correto do GitHub Releases e o coloca em /usr/local/bin/sh0.

Install

curl -fsSL https://get.sh0.dev | bash

Após a instalação, verifique com:

Verify

sh0 --version

Download Manual

Baixe o binário diretamente da página de download ou do GitHub Releases:

Manual install (Linux x64)

curl -fsSLO https://github.com/zerosuite-inc/sh0/releases/latest/download/sh0-linux-x64.tar.gz
curl -fsSLO https://github.com/zerosuite-inc/sh0/releases/latest/download/checksums.txt
sha256sum --ignore-missing -c checksums.txt
tar -xzf sh0-linux-x64.tar.gz
sudo install -m 0755 sh0 /usr/local/bin/sh0

Arquivos publicados (cada um contém o binário sh0):

sh0-linux-x64.tar.gz
sh0-linux-arm64.tar.gz
sh0-darwin-x64.tar.gz
sh0-darwin-arm64.tar.gz

Plataformas Suportadas

SO	Arquitetura	Status
Linux	x86_64	Suportado
Linux	aarch64 (ARM64)	Suportado
macOS	x86_64 (Intel)	Suportado
macOS	aarch64 (Apple Silicon)	Suportado

Autenticação

O CLI suporta dois métodos de autenticação. Use login interativo para desenvolvimento local e variáveis de ambiente para CI/CD.

Interactive login

sh0 login --url https://panel.example.com

Se omitir --url, o CLI usa a URL da sua configuração existente ou usa como padrão http://localhost:9000.

Variáveis de Ambiente

Para CI/CD e automação, defina estas variáveis de ambiente. Elas têm precedência sobre config.toml.

CI/CD credentials

export SH0_API_URL="https://panel.example.com"
export SH0_API_TOKEN="sh0_tok_..."

Tip

No GitHub Actions, armazene-as como secrets do repositório e referencie-as no seu arquivo de workflow.

Arquivo de Configuração

O CLI armazena configuração em ~/.sh0/config.toml. Este arquivo é criado automaticamente por sh0 login.

~/.sh0/config.toml

api_url = "https://panel.example.com"
token = "sh0_tok_..."
default_app = "myapi"
output = "table"  # or "json"

Todos os campos são opcionais exceto api_url e token. O default_app permite omitir o nome do app em comandos como sh0 logs.

Verificar Instalação

Após instalar e autenticar, verifique que tudo funciona:

Verify

sh0 whoami

Saída esperada:

Output

Server:  https://panel.example.com
User:    [email protected]
Role:    admin

Warning

O arquivo de configuração contém seu token de autenticação. É criado com permissões 600 (leitura/escrita somente do proprietário). Não o commite no controle de versão.

Visão geral

Deploy por push