Docs/ CLI/ Instalación

Instalación

Instalar, autenticar y configurar el CLI de sh0.

Script de instalación

La forma recomendada de instalar. El script detecta tu SO y arquitectura, descarga el binario correcto desde GitHub Releases y lo coloca en /usr/local/bin/sh0.

Install

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

Después de la instalación, verifica con:

Verify

sh0 --version

Descarga manual

Descarga el binario directamente desde la página de descarga o desde 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

Archivos publicados (cada uno contiene el binario sh0):

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

Plataformas soportadas

SO	Arquitectura	Estado
Linux	x86_64	Soportado
Linux	aarch64 (ARM64)	Soportado
macOS	x86_64 (Intel)	Soportado
macOS	aarch64 (Apple Silicon)	Soportado

Autenticación

El CLI soporta dos métodos de autenticación. Usa login interactivo para desarrollo local y variables de entorno para CI/CD.

El login interactivo solicita la URL de tu servidor, correo y contraseña. El token de sesión se almacena en ~/.sh0/config.toml.

Interactive login

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

Si omites --url, el CLI usa la URL de tu configuración existente o por defecto http://localhost:9000.

Variables de entorno

Para CI/CD y automatización, configura estas variables de entorno. Tienen prioridad sobre config.toml.

CI/CD credentials

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

Tip

En GitHub Actions, almacénalas como secretos del repositorio y referencialas en tu archivo de workflow.

Archivo de configuración

El CLI almacena la configuración en ~/.sh0/config.toml. Este archivo se crea automáticamente con sh0 login.

~/.sh0/config.toml

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

Todos los campos son opcionales excepto api_url y token. El default_app te permite omitir el nombre de la app en comandos como sh0 logs.

Verificar instalación

Después de instalar y autenticarte, verifica que todo funcione:

Verify

sh0 whoami

Salida esperada:

Output

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

Warning

El archivo de configuración contiene tu token de autenticación. Se crea con permisos 600 (solo lectura/escritura del propietario). No lo comprometas en control de versiones.

Descripción general

Despliegue por push