Référence CLI

Toutes les commandes paas avec leurs options, leurs exemples, et leurs équivalents API. La CLI couvre 100 % des actions du dashboard.

Installation

La CLI paas est un binaire unique sans dépendances. Trois moyens de l'installer.

Script universel · macOS et Linux

$ curl -fsSL https://get.di2amp.com | sh

Homebrew · macOS

$ brew install di2amp/tap/paas

Windows · PowerShell

PS> iwr https://get.di2amp.com/install.ps1 -useb | iex

Binaires portables

Téléchargement direct par OS depuis la page docs. Checksum SHA-256 fourni pour chaque binaire.

Vérification

$ paas --version
paas 1.0.0 (build 2026-04-18)

Authentification

Connexion interactive via le navigateur, ou par token pour CI/CD.

$ paas login # navigateur
$ paas login --token $PAAS_TOKEN # CI/CD
$ paas whoami
$ paas logout

Apps · paas apps

CommandeDescription
apps:create <nom>Crée une nouvelle app
apps:listListe vos apps
apps:info <nom>Détails d'une app
apps:rename <ancien> <nouveau>Renomme une app
apps:transfer <nom> <org>Transfère vers une organisation
apps:delete <nom>Supprime une app (confirmation)

Config · paas config

CommandeDescription
config:list --app <nom>Liste les variables d'env (publiques)
config:get <clé> --app <nom>Récupère une variable
config:set KEY=val --app <nom>Définit une variable
config:unset <clé> --app <nom>Supprime une variable
Les secrets (clés API, tokens, mots de passe) doivent être ajoutés via paas secrets:set, pas config:set. Les secrets ne sont jamais affichés en clair, jamais loggés.

Addons · paas addons

CommandeDescription
addons:list --app <nom>Liste les addons attachés
addons:create <type> --app <nom>Provisionne un addon
addons:info <id>Détails et credentials
addons:upgrade <id> <plan>Change le plan
addons:destroy <id>Supprime l'addon

Releases · paas releases

CommandeDescription
releases:list --app <nom>Historique des déploiements
releases:info v47 --app <nom>Détails d'une release
releases:rollback v46 --app <nom>Rollback vers une release antérieure

Logs · paas logs

$ paas logs --app monsite # 100 dernières lignes
$ paas logs --tail --app monsite # streaming live
$ paas logs --source web --tail # filtré par process
$ paas logs --num 1000 --since 1h # dernière heure

Processes · paas ps

CommandeDescription
ps:list --app <nom>Liste des process et leur état
ps:scale web=3 --app <nom>Scale horizontal d'un type
ps:restart --app <nom>Redémarre tous les process

Run et shell · paas run · paas shell

Exécuter une commande ponctuelle dans le contexte de l'app (mêmes variables d'environnement, mêmes secrets, mêmes addons) ou ouvrir un shell interactif. Idéal pour les migrations de base, les rake tasks, l'inspection rapide.

$ paas run --app monsite -- rails db:migrate # tâche one-shot
$ paas run --app monsite -- python manage.py createsuperuser
$ paas shell --app monsite # shell interactif
$ paas shell --app monsite --type worker # shell dans le pod worker

Les sessions shell tournent dans un pod éphémère cloné de votre release courante. Elles n'occupent aucun slot du quota web ou worker. La session se ferme automatiquement après 60 minutes d'inactivité.

Domaines · paas domains

$ paas domains:add app.exemple.fr --app monsite
$ paas domains:list --app monsite
$ paas domains:verify app.exemple.fr
$ paas domains:remove app.exemple.fr --app monsite

Agents IA · paas agents

CommandeDescription
agents:listÉtat de vos 6 agents
agents:enable <agent>Active un agent sur le compte
agents:disable <agent>Désactive un agent
agents:configure <agent> --mode read-onlyMode lecture seule
agents:insights <agent> --app <nom>Suggestions actuelles

Équipes · paas teams

CommandeDescription
teams:listVos équipes et organisations
teams:create <nom>Crée une organisation
teams:invite <email> --role developerInvite un membre
teams:remove <email>Retire un membre
teams:rolesListe des rôles disponibles