Docs/ CLI/ Installation

Installation

Installer, s'authentifier et configurer le CLI sh0.

Script d'installation

La méthode d'installation recommandée. Le script détecte votre OS et architecture, télécharge le bon binaire depuis les GitHub Releases et le place dans /usr/local/bin/sh0.

Install

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

Après l'installation, vérifiez avec :

Verify

sh0 --version

Téléchargement manuel

Téléchargez le binaire directement depuis la page de téléchargement ou depuis les GitHub Releases :

Manual install (Linux x64)

curl -Lo sh0 https://github.com/zerosuite-inc/sh0/releases/latest/download/sh0-linux-x86_64
chmod +x sh0
sudo mv sh0 /usr/local/bin/

Noms de binaires disponibles :

sh0-linux-x86_64
sh0-linux-aarch64
sh0-darwin-x86_64
sh0-darwin-aarch64

Plateformes supportées

OS	Architecture	Statut
Linux	x86_64	Supporté
Linux	aarch64 (ARM64)	Supporté
macOS	x86_64 (Intel)	Supporté
macOS	aarch64 (Apple Silicon)	Supporté

Authentification

Le CLI supporte deux méthodes d'authentification. Utilisez la connexion interactive pour le développement local et les variables d'environnement pour le CI/CD.

La connexion interactive demande l'URL de votre serveur, votre e-mail et votre mot de passe. Le jeton de session est stocké dans ~/.sh0/config.toml.

Interactive login

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

Si vous omettez --url, le CLI utilise l'URL de votre configuration existante ou se rabat sur http://localhost:9000.

Variables d'environnement

Pour le CI/CD et l'automatisation, définissez ces variables d'environnement. Elles ont priorité sur config.toml.

CI/CD credentials

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

Tip

Dans GitHub Actions, stockez-les comme secrets du dépôt et référencez-les dans votre fichier de workflow.

Fichier de configuration

Le CLI stocke la configuration dans ~/.sh0/config.toml. Ce fichier est créé automatiquement par sh0 login.

~/.sh0/config.toml

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

Tous les champs sont optionnels sauf api_url et token. Le champ default_app vous permet d'omettre le nom de l'app dans des commandes comme sh0 logs.

Vérifier l'installation

Après l'installation et l'authentification, vérifiez que tout fonctionne :

Verify

sh0 whoami

Sortie attendue :

Output

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

Warning

Le fichier de configuration contient votre jeton d'authentification. Il est créé avec les permissions 600 (lecture/écriture propriétaire uniquement). Ne le committez pas dans le contrôle de version.

Overview

Push Deploy