Référence CLI Rediacc

Aperçu

La **CLI Rediacc** (`rdc`) est une interface en ligne de commande pour gérer tous les aspects de la plateforme Rediacc — authentification, infrastructure, dépôts, files d'attente, stockage et plus encore.

Guide d'installation

Téléchargez le dernier binaire pour votre plateforme depuis la [page des versions Rediacc](https://www.rediacc.com) ou installez via votre gestionnaire de paquets :

# macOS / Linux
curl -fsSL https://www.rediacc.com | sh

# Or use the packaged binary directly
./rdc --help

Options Globales

Chaque commande prend en charge ces flags globaux :

Option	Libellé
`--output`	Format de sortie (table\|json\|yaml\|csv). Remplacer la valeur par défaut avec REDIACC_DEFAULT_OUTPUT.
`--config`	Utiliser une configuration spécifique pour cette commande
`--lang`	Remplacement de langue ({{languages}})
`--force`	Ignorer les invites de confirmation

1. Utilitaires de l'agent

Utilitaires pour les assistants de codage IA

1.1 capabilities

Lister toutes les commandes disponibles avec leurs arguments et options

rdc agent capabilities

1.2 schema

Afficher le schéma détaillé d'une commande spécifique

rdc agent schema [options]

Option	Libellé	Requis	Défaut
`--command <path>`	Exécuter une commande au lieu d'un shell interactif	Oui	-

1.3 exec

Exécuter une commande avec une entrée JSON depuis stdin

rdc agent exec [options]

Option	Libellé	Requis	Défaut
`--command <path>`	Exécuter une commande au lieu d'un shell interactif	Oui	-

1.4 generate-reference

Générer la référence des commandes en Markdown pour les compétences Claude

rdc agent generate-reference

2. Gestion de la Configuration

Gérer les fichiers de configuration, machines et connexions SSH

Les fichiers de configuration stockent les informations de connexion (URL API, identifiants, équipe/région/pont par défaut) pour basculer rapidement entre les environnements.

2.1 prune

Supprime le poids mort du fichier de configuration local dans ~/.config/rediacc/<config>.json. Trois catégories sont nettoyées, toutes purement locales (aucun appel SSH/renet) : (1) les entrées du cache de certificats ACME dont l'ancre GUID/repo/machine n'est plus dans la configuration active ; (2) les dépôts archivés dont la période de grâce a expiré (7 jours par défaut, voir defaults.pruneGraceDays) ; (3) les références croisées orphelines (machine→strategy, strategy→repo). Les ressources actives, identifiants, jetons de stockage et known-hosts ne sont jamais touchés. Le comportement par défaut applique les changements ; passez --dry-run pour prévisualiser uniquement.

rdc config prune [options]

Option	Libellé	Requis	Défaut
`--dry-run`	Prévisualise ce qui serait supprimé sans modifier le fichier de configuration. Reflète la sémantique désactivée par défaut des autres commandes prune.	Non	-
`--certs-only`	Limite au bucket du cache de certificats ACME. Ignore la purge d'archives et le nettoyage de références croisées. Mutuellement exclusif avec --archives-only et --refs-only.	Non	-
`--archives-only`	Limite à la purge des archives expirées. Ignore le cache de certificats et le nettoyage de références croisées. Exclusif avec --certs-only et --refs-only.	Non	-
`--refs-only`	Limite aux références croisées orphelines (machine→strategy, strategy→repo excludes/includes). Ignore le cache de certificats et les archives. Exclusif avec --certs-only et --archives-only.	Non	-
`--purge-archived`	Supprime TOUS les dépôts archivés indépendamment de l'âge, pas seulement ceux après la grâce. Équivalent à exécuter 'rdc config repository purge-archived'. À n'utiliser que si vous êtes sûr de ne plus avoir besoin des identifiants stockés pour la restauration.	Non	-
`--grace-days <days>`	Remplace la fenêtre de grâce d'archive (en jours) pour cette invocation. Repli sur defaults.pruneGraceDays dans la configuration, puis sur 7 si aucun n'est défini.	Non	-

2.2 init

Créer un nouveau fichier de configuration nommé

En mode local, vous pouvez ajouter des machines directement :

rdc config init [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`--ssh-key <path>`	Chemin vers la clé privée SSH (ex. ~/.ssh/id_rsa)	Non	-
`--renet-path <path>`	Chemin vers le binaire renet (par défaut : renet dans PATH)	Non	-
`--master-password <password>`	Chiffrer les ressources avec un mot de passe principal	Non	-
`-u, --api-url <url>`	URL de l'API	Non	-
`--server <url>`	URL du serveur de compte	Non	-

2.3 list

Lister tous les fichiers de configuration

rdc config list

2.4 show

Afficher les détails de la configuration actuelle

rdc config show [options]

Option	Libellé	Requis	Défaut
`--reveal`	Afficher en clair les valeurs sensibles (mode interactif uniquement)	Non	-

2.5 delete

Supprimer un fichier de configuration

rdc config delete [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-

2.6 set

Définir une valeur par défaut (équipe, région, pont)

rdc config set [options]

Option	Libellé	Requis	Défaut
`--key <key>`	Clé de configuration	Oui	-
`--value <value>`	Valeur de configuration	Oui	-

Astuce: Définir des valeurs par défaut évite de passer `--team`, `--region` ou `--bridge` à chaque commande.

2.7 clear

Effacer les valeurs par défaut (toutes ou une clé spécifique)

rdc config clear [options]

Option	Libellé	Requis	Défaut
`--key <key>`	Clé de configuration	Non	-

2.8 recover

Restaurer la configuration depuis le fichier de sauvegarde (.bak)

rdc config recover [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`-y, --yes`	Ignorer l'invite de confirmation	Non	-

2.9 set-ssh

Mettre à jour la configuration SSH pour la configuration actuelle

rdc config set-ssh

2.10 set-renet

Définir le chemin vers le binaire renet pour le mode local

rdc config set-renet

2.11 ssh

Gérer la configuration de la clé SSH

set

Définir la clé SSH pour la configuration actuelle

rdc config ssh set [options]

Option	Libellé	Requis	Défaut
`--key <path>`	Chemin vers le fichier de clé SSH privée	Oui	-
`--embed`	Intégrer le contenu de la clé dans la configuration au lieu de stocker le chemin	Non	-

show

Afficher la configuration actuelle de la clé SSH

rdc config ssh show

remove

Supprimer la clé SSH de la configuration actuelle

rdc config ssh remove

2.12 remote

Gérer la connexion au stockage distant de configuration

enable

Lier cette configuration au stockage distant chiffré

rdc config remote enable [options]

Option	Libellé	Requis	Défaut
`--headless`	Utiliser le flux de code d'appareil (pour les serveurs sans interface)	Non	-
`--api-url <url>`	URL du serveur de compte	Non	-

disable

Déconnecter du stockage distant et sauvegarder la configuration localement

rdc config remote disable

status

Afficher l'état de la connexion distante

rdc config remote status

refresh

Forcer la récupération de la configuration depuis le stockage distant

rdc config remote refresh

2.13 machine

Gérer les machines dans la configuration actuelle

add

Ajouter une machine à la configuration actuelle

rdc config machine add [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--ip <address>`	Adresse IP ou nom d'hôte de la machine	Oui	-
`--user <username>`	Nom d'utilisateur SSH	Oui	-
`--port <port>`	Port SSH	Non	`22`
`--datastore <path>`	Chemin du magasin de données sur la machine	Non	`/mnt/rediacc`

remove

Supprimer une machine de la configuration actuelle

rdc config machine remove [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-

list

Lister les machines dans la configuration actuelle

rdc config machine list

scan-keys

Scanner les clés d'hôte SSH pour les machines de la configuration actuelle

rdc config machine scan-keys [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Non	-

setup

Provisionner une machine distante pour les dépôts (installe renet, configure Docker, datastore BTRFS). Idempotent. Requis après config machine add et avant repo create

rdc config machine setup [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--datastore <path>`	Chemin du datastore sur la machine distante	Non	`/mnt/rediacc`
`--datastore-size <size>`	Taille du datastore (ex. : 95%, 100G)	Non	`95%`
`--debug`	Activer la sortie de débogage (mode local)	Non	-

set-ceph

Définir la configuration Ceph RBD pour une machine

rdc config machine set-ceph [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--pool <name>`	Nom du pool Ceph (ex., rbd)	Oui	-
`--image <name>`	Nom de l'image RBD (ex., datastore-prod1)	Oui	-
`--cluster <name>`	Nom du cluster Ceph	Non	`ceph`

2.14 repository

Gérer les mappages de dépôts dans la configuration actuelle

add

Ajouter un mappage GUID de dépôt à la configuration actuelle

rdc config repository add [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--guid <guid>`	GUID du dépôt (UUID des noms de fichiers de sauvegarde)	Oui	-
`--tag <tag>`	Étiquette du dépôt	Non	`latest`
`--credential <credential>`	Identifiant du dépôt (phrase de passe de chiffrement)	Non	-
`--network-id <id>`	ID réseau pour l'isolation Docker (2816, 2880, ...). Attribué automatiquement si omis	Non	-

remove

Supprimer un mappage de dépôt de la configuration actuelle

rdc config repository remove [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-

list

Lister les mappages GUID de dépôts dans la configuration actuelle

rdc config repository list

list-archived

Lister les identifiants de dépôts archivés

rdc config repository list-archived

restore-archived

Restaurer un identifiant de dépôt archivé

rdc config repository restore-archived [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--new-name <name>`	Nouveau nom de la ressource	Non	-

purge-archived

Supprimer définitivement tous les identifiants archivés

rdc config repository purge-archived

2.15 provider

Gérer les fournisseurs cloud pour le provisionnement automatique de machines

add

Ajouter un fournisseur cloud

rdc config provider add [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--provider <source>`	Source de fournisseur connue (ex., linode/linode, hetznercloud/hcloud)	Non	-
`--source <source>`	Source personnalisée de fournisseur OpenTofu (ex., vultr/vultr)	Non	-
`--token <token>`	Jeton API pour le fournisseur cloud	Oui	-
`--region <region>`	Région par défaut pour les nouvelles machines	Non	-
`--type <type>`	Type/taille d'instance par défaut	Non	-
`--image <image>`	Image OS par défaut	Non	-
`--ssh-user <user>`	Nom d'utilisateur SSH pour les nouvelles VMs (par défaut : root)	Non	-
`--resource <type>`	Personnalisé : type de ressource OpenTofu pour les VMs	Non	-
`--label-attr <attr>`	Personnalisé : nom d'attribut pour le libellé de la VM	Non	-
`--region-attr <attr>`	Personnalisé : nom d'attribut pour la région	Non	-
`--size-attr <attr>`	Personnalisé : nom d'attribut pour le type d'instance	Non	-
`--image-attr <attr>`	Personnalisé : nom d'attribut pour l'image du système d'exploitation	Non	-
`--ipv4-output <attr>`	Personnalisé : attribut de sortie pour l'adresse IPv4	Non	-
`--ipv6-output <attr>`	Personnalisé : attribut de sortie pour l'adresse IPv6	Non	-
`--ssh-key-attr <attr>`	Personnalisé : nom d'attribut pour les clés SSH	Non	-
`--ssh-key-format <format>`	Personnalisé : format de clé SSH (inline_list ou resource_id)	Non	-
`--ssh-key-resource <type>`	Personnalisé : type de ressource OpenTofu pour les clés SSH	Non	-

remove

Supprimer la configuration d'un fournisseur cloud

rdc config provider remove [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-

list

Lister les fournisseurs cloud configurés

rdc config provider list

2.16 storage

Gérer les backends de stockage dans la configuration actuelle

import

Importer des stockages depuis un fichier de configuration rclone

rdc config storage import [options]

Option	Libellé	Requis	Défaut
`--file <path>`	Chemin du fichier	Oui	-
`--name <name>`	Importer uniquement cette section nommée	Non	-

remove

Supprimer un stockage de la configuration actuelle

rdc config storage remove [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-

list

Lister les stockages dans la configuration actuelle

rdc config storage list

2.17 infra

Gérer la configuration d'infrastructure (proxy, DNS, certificats)

set

Définir la configuration d'infrastructure pour une machine (spécifique à la machine : IPs, domaine, ports ; partagé : email de certificat, token DNS Cloudflare)

rdc config infra set [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--public-ipv4 <ip>`	Adresse IPv4 publique (par machine)	Non	-
`--public-ipv6 <ip>`	Adresse IPv6 publique (par machine)	Non	-
`--base-domain <domain>`	Domaine de base pour les applications (par machine)	Non	-
`--cert-email <email>`	E-mail pour les notifications de certificats TLS (partagé entre machines)	Non	-
`--cf-dns-token <token>`	Jeton Cloudflare DNS API pour le défi ACME DNS-01 (partagé entre machines)	Non	-
`--tcp-ports <ports>`	Ports TCP à rediriger (séparés par des virgules, ex., 25,143,465)	Non	-
`--udp-ports <ports>`	Ports UDP à rediriger (séparés par des virgules, ex., 53)	Non	-

show

Afficher la configuration d'infrastructure pour une machine

rdc config infra show [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-

push

Envoyer la configuration d'infrastructure à la machine (proxy Traefik, routeur, Cloudflare DNS). Exécutez d'abord 'config infra set <machine>'

rdc config infra push [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

2.18 cert-cache

Gérer les certificats TLS en cache

pull

Télécharger et mettre en cache les certificats TLS depuis une machine

rdc config cert-cache pull [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--no-prune`	Ne pas nettoyer les certificats d'ID réseau obsolètes	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

push

Envoyer les certificats TLS en cache vers une machine

rdc config cert-cache push [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

status

Afficher l'inventaire des certificats en cache

rdc config cert-cache status

clear

Supprimer le cache de certificats

rdc config cert-cache clear

2.19 field

Opérations sur les champs de configuration adressés par pointeur (get/set/unset/rotate/list). Pointeurs JSON (RFC 6901) tels que /credentials/cfDnsApiToken.

get

Lire une valeur de configuration via un pointeur JSON. Les champs sensibles sont masqués sauf avec --reveal (humains uniquement).

rdc config field get [options]

Option	Libellé	Requis	Défaut
`--pointer <pointer>`	Pointeur JSON vers le champ (ex : /credentials/cfDnsApiToken)	Oui	-
`--reveal`	Afficher les valeurs sensibles en clair (TTY interactif uniquement ; audité)	Non	-
`--digest`	Afficher l'empreinte SHA-256 au lieu de la valeur (sûr à partager avec des agents)	Non	-

set

Écrire une valeur de configuration à un pointeur JSON. Les chemins sensibles exigent --current (preuve de connaissance).

rdc config field set [options]

Option	Libellé	Requis	Défaut
`--pointer <pointer>`	Pointeur JSON vers le champ (ex : /credentials/cfDnsApiToken)	Oui	-
`--new <value>`	Nouvelle valeur (interprétée comme JSON si elle commence par {, [, ", true, false, null ou un nombre)	Oui	-
`--current <value>`	Valeur actuelle en clair — requise pour modifier les chemins sensibles (preuve de connaissance)	Non	-

unset

Supprimer une valeur de configuration à un pointeur JSON. Les chemins sensibles exigent --current.

rdc config field unset [options]

Option	Libellé	Requis	Défaut
`--pointer <pointer>`	Pointeur JSON vers le champ (ex : /credentials/cfDnsApiToken)	Oui	-
`--current <value>`	Valeur actuelle en clair — requise pour supprimer les chemins sensibles	Non	-

rotate

Rotation d'une valeur sensible sans --current. TTY interactif uniquement ; audité en évidence.

rdc config field rotate [options]

Option	Libellé	Requis	Défaut
`--pointer <pointer>`	Pointeur JSON vers le champ sensible (ex : /credentials/cfDnsApiToken)	Oui	-
`--new <value>`	Nouvelle valeur	Oui	-

list

Lister chaque modèle de pointeur enregistré avec son type et sa politique de commit/chiffrement.

rdc config field list [options]

Option	Libellé	Requis	Défaut
`--sensitive`	Afficher uniquement les modèles sensibles (non publics)	Non	-

2.20 edit

Ouvre la configuration active dans $EDITOR comme projection JSONC caviardée. Humains uniquement ; les agents sont refusés.

rdc config edit [options]

Option	Libellé	Requis	Défaut
`--reveal`	Afficher les valeurs sensibles en clair (TTY interactif uniquement ; audité)	Non	-
`--dump`	Afficher la configuration actuelle en JSONC sur stdout au lieu d'ouvrir l'éditeur (lecture seule ; sûr pour les agents si caviardé)	Non	-
`--apply <file>`	Appliquer un fichier JSONC modifié (saute le lancement de $EDITOR)	Non	-
`--current-secrets <file>`	Fichier JSON mappant pointeur→ancien texte en clair pour la porte de connaissance sur --apply	Non	-
`--editor <cmd>`	Commande d'éditeur (suit la priorité git : --editor > $GIT_EDITOR > git config core.editor > $VISUAL > $EDITOR)	Non	-

2.21 audit

Inspecter le journal d'audit de configuration (JSONL chaîné par hachage dans ~/.config/rediacc/audit.log.jsonl)

log

Afficher les entrées d'audit récentes au format JSON

rdc config audit log [options]

Option	Libellé	Requis	Défaut
`--since <spec>`	Afficher les entrées postérieures à (ex. : '24h', '7d', horodatage ISO)	Non	-
`--path <glob>`	Filtrer par motif de pointeur JSON (ex. : /credentials/*)	Non	-
`--actor <kind>`	Filtrer par type d'acteur (human\|agent)	Non	-

tail

Diffuser les nouvelles entrées en temps réel (Ctrl+C pour arrêter)

rdc config audit tail

verify

Vérifier l'intégrité de la chaîne SHA-256 de toutes les entrées d'audit

rdc config audit verify

2.22 backup-strategy

Gérer les stratégies de sauvegarde nommées (modes chaud/froid, destinations, planification)

set

Créer ou mettre à jour une stratégie de sauvegarde

rdc config backup-strategy set [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la stratégie (requis)	Oui	-
`--destination <name>`	Nom de la destination au sein de la stratégie	Non	-
`--storage <name>`	Nom de la configuration de stockage (identifiants rclone)	Non	-
`--cron <expression>`	Planification cron (ex. "0 * * * *" pour toutes les heures)	Non	-
`--mode <mode>`	Mode de sauvegarde : "hot" (sans interruption) ou "cold" (arrêt, instantané, redémarrage)	Non	-
`--bwlimit <limit>`	Limite de bande passante rclone (ex. "6M", "10M:off", "08:00,3M;22:00,10M")	Non	-
`--include <repos>`	Sauvegarder uniquement ces repos (noms séparés par des virgules)	Non	-
`--exclude <repos>`	Exclure ces repos de la sauvegarde (noms séparés par des virgules)	Non	-
`--folder <path>`	Sous-dossier dans le bucket de stockage pour cette destination (ex. hot, cold)	Non	-
`--enable`	Activer la stratégie ou la destination	Non	-
`--disable`	Désactiver la stratégie ou la destination	Non	-

remove

Supprimer une stratégie de sauvegarde ou une destination

rdc config backup-strategy remove [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la stratégie (requis)	Oui	-
`--destination <name>`	Supprimer uniquement cette destination (conserve les autres destinations)	Non	-

list

Lister toutes les stratégies de sauvegarde

rdc config backup-strategy list

show

Afficher les détails de la stratégie de sauvegarde

rdc config backup-strategy show [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la stratégie (affiche toutes si omis)	Non	-

3. Gestion du stockage de données

Gérer le cycle de vie du datastore Ceph RBD (init, fork, unfork, status)

3.1 init

Initialiser le datastore sur une machine (local ou Ceph RBD)

rdc datastore init [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine (où le datastore Ceph est hébergé)	Oui	-
`--size <size>`	Taille du datastore (ex. : 5G, 50G, 100G)	Oui	-
`--backend <type>`	Type de backend : local (par défaut) ou ceph	Non	`local`
`--pool <name>`	Nom du pool Ceph (par défaut : depuis la configuration de la machine, ou rbd)	Non	`rbd`
`--image <name>`	Nom de l'image Ceph RBD (par défaut : depuis la configuration de la machine via set-ceph)	Non	-
`--cluster <name>`	Nom du cluster Ceph (par défaut : ceph)	Non	`ceph`
`--force`	Forcer l'initialisation même si le datastore existe déjà (ATTENTION : reformate le stockage)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

3.2 fork

Créer une copie COW locale d'un datastore Ceph via snapshot + clone RBD (< 2s). Conservez les noms de snapshot/clone de la sortie pour unfork. Un seul fork par nom de cible ; exécutez unfork avant de refaire un fork

rdc datastore fork [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine (où le datastore Ceph est hébergé)	Oui	-
`--to <name>`	Suffixe du clone (crée un clone nommé <image>-fork-<name>). Le fork reste sur la machine source	Oui	-
`--cow-size <size>`	Taille du fichier de sauvegarde COW (par défaut : auto, croît à la demande)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

3.3 unfork

Nettoyer un fork : démonter COW, supprimer le clone, supprimer le snapshot

rdc datastore unfork [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine (où le datastore Ceph est hébergé)	Oui	-
`--source <image>`	Image RBD originale qui a été forkée (de config set-ceph --image, ex. ds-prod)	Oui	-
`--snapshot <name>`	Snapshot à supprimer (la valeur "Snapshot:" de la sortie fork, ex. fork-<timestamp>)	Oui	-
`--dest <image>`	Image de clone à supprimer (la valeur "Clone:" de la sortie fork, ex. ds-prod-fork-<machine>)	Oui	-
`--pool <name>`	Nom du pool Ceph (par défaut : depuis la configuration de la machine)	Non	-
`--mount-point <path>`	Point de montage du fork à démonter (par défaut : /mnt/rediacc)	Non	-
`--force`	Continuer le nettoyage même si des étapes individuelles échouent (ex. : démontage, suppression de snapshot)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

3.4 status

Afficher le backend, la taille, l'utilisation, l'état de montage et cow_mode (si forké) du datastore

rdc datastore status [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine (où le datastore Ceph est hébergé)	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

4. Gestion des Machines

Gérer les machines distantes (état, conteneurs, services, santé)

4.1 list

Lister les machines

rdc machine list [options]

Option	Libellé	Requis	Défaut
`-t, --team <name>`	Nom de l'équipe	Non	-
`--search <text>`	Rechercher dans {{field}}	Non	-
`--sort <field>`	Trier par champ	Non	-
`--desc`	Ordre décroissant	Non	-

4.2 create

Créer une nouvelle machine

rdc machine create [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-
`-b, --bridge <name>`	Nom du pont	Non	-
`--vault <json>`	Données du coffre de la machine en tant que chaîne JSON	Non	-

4.3 rename

Renommer une machine

rdc machine rename [options]

Option	Libellé	Requis	Défaut
`--current-name <name>`	Nom actuel de la ressource	Oui	-
`--new-name <name>`	Nouveau nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-

4.4 delete

Supprimer une machine

rdc machine delete [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-
`-f, --force`	Ignorer les invites de confirmation	Non	-
`--dry-run`	Afficher les actions prévues sans effectuer de modifications	Non	-

4.5 vault

Gestion du coffre-fort machine (adaptateur cloud uniquement)

rdc machine vault

4.6 vault-status

rdc machine vault-status [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-

4.7 update

Mettre à jour la configuration de la machine

rdc machine update

4.8 health

Vérifier la santé de la machine pour les pipelines CI/CD

La commande health affiche les métriques système, l'état des conteneurs, la stabilité des services et les informations de stockage — utile pour les vérifications de pipeline CI/CD.

rdc machine health [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-

4.9 containers

Lister les conteneurs en cours d'exécution sur une machine

rdc machine containers [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-
`--health-check`	Mode de vérification de santé - sort avec le code 2 si des conteneurs ne sont pas sains	Non	-

4.10 services

Lister les services systemd sur une machine

rdc machine services [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-
`--stability-check`	Mode de vérification de stabilité - sort avec le code 2 si des services échouent/redémarrent	Non	-

4.11 query

Afficher l'état complet de la machine (système, dépôts, conteneurs, services)

rdc machine query [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--system`	Inclure uniquement les informations système	Non	-
`--repositories`	Inclure uniquement les dépôts	Non	-
`--containers`	Inclure uniquement les conteneurs	Non	-
`--services`	Inclure uniquement les services	Non	-
`--network`	Inclure uniquement les interfaces réseau	Non	-
`--block-devices`	Inclure uniquement les périphériques de bloc	Non	-
`--licenses`	Inclure les statuts de licences des dépôts	Non	-
`--storage-health`	Afficher la fragmentation BTRFS et les économies reflink par dépôt	Non	-
`--sync-certs`	Récupère aussi le cache de certificats ACME de la machine après la requête	Non	-
`--strict`	Sortir avec un code non nul (code 2) si un conteneur a dépassé le seuil de dérive de santé	Non	-

4.12 vault-status

Afficher l'état du coffre analysé pour une machine

rdc machine vault-status [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-

4.13 repos

Lister les dépôts déployés sur une machine

rdc machine repos [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-
`--search <text>`	Filtrer les dépôts par nom	Non	-

4.14 test-connection

Tester la connexion SSH à une machine et capturer la clé d'hôte

rdc machine test-connection [options]

Option	Libellé	Requis	Défaut
`--ip <address>`	Adresse IP ou nom d'hôte de la machine	Oui	-
`--user <name>`	Nom d'utilisateur SSH	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-
`-b, --bridge <name>`	Nom du pont	Non	-
`--port <number>`	Port SSH	Non	`22`
`--password <pwd>`	Mot de passe SSH pour l'authentification initiale	Non	-
`--datastore <path>`	Chemin du magasin de données sur la machine	Non	`/mnt/rediacc`
`-m, --machine <name>`	Nom de la machine (pour mettre à jour le coffre après test)	Non	-
`--save`	Enregistrer known_hosts dans le coffre de la machine après test réussi	Non	-

Astuce: Utilisez `--save-known-hosts` pour persister automatiquement la clé de l'hôte dans le vault de la machine après un test réussi.

4.15 provision

Provisionner une nouvelle machine chez un fournisseur cloud avec OpenTofu

rdc machine provision [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--provider <name>`	Nom du fournisseur cloud (depuis config provider add)	Oui	-
`--region <region>`	Remplacer la région par défaut	Non	-
`--type <type>`	Remplacer le type d'instance par défaut	Non	-
`--image <image>`	Remplacer l'image OS par défaut	Non	-
`--ssh-user <user>`	Nom d'utilisateur SSH pour la nouvelle VM (par défaut : root)	Non	-
`--base-domain <domain>`	Domaine de base pour l'infrastructure (ex. example.com). Implique --infra	Non	-
`--no-infra`	Ignorer la configuration d'infrastructure (proxy + DNS)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

4.16 deprovision

Détruire une machine provisionnée dans le cloud et la supprimer de la configuration

rdc machine deprovision [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--force`	Ignorer l'invite de confirmation	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

4.17 backup

Gestion des sauvegardes machine

list

Lister les stratégies de sauvegarde liées à toutes les machines

rdc machine backup list

schedule

Déployer la planification de sauvegarde sur une machine distante (minuteries systemd)

rdc machine backup schedule [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--dry-run`	Prévisualiser les unités générées sans déployer	Non	-
`--force`	Continuer même si une sauvegarde est en cours (la nouvelle unité s'applique au prochain tick du minuteur ; l'invocation en cours conserve son ancienne unité)	Non	-
`--reset-failed`	Effacer l'état d'échec des services modifiés après un déploiement réussi (désactivé par défaut, préserve le signal d'échec)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

now

Déclencher une sauvegarde immédiatement sur une machine distante

rdc machine backup now [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--strategy <name>`	Nom de la stratégie (déclenche toutes si omis)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

status

Afficher l'état de sauvegarde et l'état du minuteur sur une machine distante

rdc machine backup status [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--strategy <name>`	Afficher les détails d'une stratégie spécifique	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

cancel

Annuler une sauvegarde en cours sur une machine distante

rdc machine backup cancel [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-
`--strategy <name>`	Nom de la stratégie (annule toutes si omis)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

4.18 prune

Supprimer les ressources orphelines du datastore et les instantanés périmés d'une machine

rdc machine prune [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--dry-run`	Afficher ce qui serait supprimé sans effectuer de modifications	Non	-
`--orphaned-repos`	Supprimer aussi les images de dépôts absents de toute configuration	Non	-
`--prune-unknown`	Supprime uniquement les dépôts que le miroir renet .interim/state ne peut pas classer (pas dans la configuration locale ET pas de miroir marqué fork). Strictement plus restreint que --orphaned-repos : les forks sans configuration sont préservés quand le miroir les identifie. Les orphelins hérités pré-miroir et les grands obsolètes dont l'entrée de configuration a été supprimée tombent tous dans cette catégorie.	Non	-
`--force-delete-mounted`	Remplace la vérification de sécurité de montage et supprime les dépôts même s'ils sont actuellement montés ou ont des conteneurs Docker en cours. Distinct de --force (qui ne remplace que la période de grâce d'archive). S'applique à la fois à --orphaned-repos et à --prune-unknown.	Non	-
`--force`	Ignorer les invites de confirmation	Non	-
`--grace-days <days>`	Période de grâce en jours pour les dépôts récemment archivés (par défaut : 7)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

5. Serveur MCP

Serveur Model Context Protocol pour les agents IA

5.1 serve

Démarrer le serveur MCP (transport stdio)

rdc mcp serve [options]

Option	Libellé	Requis	Défaut
`--config <name>`	Nom de la configuration à utiliser pour toutes les commandes	Non	-
`--timeout <ms>`	Délai d'expiration par défaut des commandes en millisecondes	Non	`120000`
`--allow-grand`	Autoriser les opérations destructives sur les dépôts grand (non fork). Par défaut : mode fork uniquement	Non	-

6. Cycle de vie des dépôts

Déployer et gérer des dépôts chiffrés sur les machines

6.1 mount

Monter un dépôt (ouvrir le conteneur LUKS)

rdc repo mount [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--checkpoint`	Restaurer depuis un point de contrôle après le montage	Non	-
`--no-docker`	Ne pas démarrer le démon Docker après le montage	Non	-
`--parallel`	Démarrer les dépôts simultanément	Non	-
`--concurrency <n>`	Nombre maximum de dépôts simultanés (par défaut : 3)	Non	`3`
`-y, --yes`	Passer la confirmation pour les opérations par lots	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.2 unmount

Démonter un dépôt

rdc repo unmount [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--checkpoint`	Créer un point de contrôle avant le démontage	Non	-
`--parallel`	Démarrer les dépôts simultanément	Non	-
`--concurrency <n>`	Nombre maximum de dépôts simultanés (par défaut : 3)	Non	`3`
`-y, --yes`	Passer la confirmation pour les opérations par lots	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.3 up

Déployer ou mettre à jour un dépôt (montage, démarrage des services)

rdc repo up [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--skip-checkpoint`	Ignorer la restauration du checkpoint CRIU même si des données de checkpoint existent (forcer un démarrage propre)	Non	-
`--tls`	Demander un certificat TLS dédié pour ce dépôt (les forks utilisent le certificat partagé de la machine par défaut)	Non	-
`--include-forks`	Également monter/démarrer les dépôts forkés	Non	-
`--mount-only`	Monter uniquement, sans démarrer les services	Non	-
`--parallel`	Démarrer les dépôts simultanément	Non	-
`--concurrency <n>`	Nombre maximum de dépôts simultanés (par défaut : 3)	Non	`3`
`-y, --yes`	Passer la confirmation pour les opérations par lots	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-
`--dry-run`	Afficher les actions prévues sans effectuer de modifications	Non	-

6.4 up-all

Déployer tous les dépôts sur une machine

rdc repo up-all

6.5 down

Arrêter les services du dépôt

rdc repo down [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--unmount`	Démonter le dépôt après l'arrêt	Non	-
`--checkpoint`	Créer un checkpoint CRIU avant l'arrêt (sauvegarder l'état mémoire des processus pour restauration ultérieure via 'repo up')	Non	-
`-y, --yes`	Passer la confirmation pour les opérations par lots	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-
`--dry-run`	Afficher les actions prévues sans effectuer de modifications	Non	-

6.6 status

Obtenir le statut du dépôt

rdc repo status [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.7 list

Lister les dépôts sur une machine

rdc repo list [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.8 create

Créer un nouveau dépôt chiffré

rdc repo create [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--size <size>`	Taille du dépôt (ex. 10G, 100G, 1T)	Oui	-
`--no-docker`	Ne pas démarrer le démon Docker après la création	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.9 delete

Supprimer un dépôt (détruit les conteneurs, volumes et l'image chiffrée). L'entrée de configuration est conservée. Utilisez --archive-config pour déplacer les identifiants vers deletedRepositories pour récupération via 'config restore-archived'

rdc repo delete [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--archive-config`	Déplacer l'entrée de configuration vers deletedRepositories pour récupération ultérieure	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-
`--dry-run`	Afficher les actions prévues sans effectuer de modifications	Non	-

6.10 fork

Créer un fork CoW (Copy-on-Write) d'un dépôt

rdc repo fork [options]

Option	Libellé	Requis	Défaut
`--parent <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--tag <name>`	Tag pour le fork (crée nom:tag)	Oui	-
`--checkpoint`	Créer un checkpoint CRIU sur la source avant le fork (capturer l'état mémoire des processus pour restauration sur le fork)	Non	-
`--up`	Monter et démarrer les services après le fork (fork + mount + up en une seule commande)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.11 takeover

Remplacer les données du dépôt principal par les données d'un fork. Le principal conserve son identité (GUID, networkId, domaines, démarrage automatique, chaîne de sauvegardes) mais obtient les données mises à jour du fork. Les anciennes données de production sont conservées comme fork de sauvegarde. Utilisation : tester la mise à niveau sur le fork → vérifier → prise de contrôle en production.

rdc repo takeover [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--force`	Ignorer les avertissements de modification	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.12 resize

Redimensionner un dépôt hors ligne (supporte l'expansion et la réduction)

rdc repo resize [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--size <size>`	Nouvelle taille du dépôt (ex. 10G, 100G, 1T)	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.13 expand

Étendre un dépôt monté en ligne (sans interruption)

rdc repo expand [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--size <size>`	Nouvelle taille du dépôt (ex. 10G, 100G, 1T)	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.14 validate

Valider l'intégrité du dépôt

rdc repo validate [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.15 autostart

Gérer le démarrage automatique des dépôts au démarrage

enable

Activer le démarrage automatique pour un dépôt

rdc repo autostart enable [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

disable

Désactiver le démarrage automatique pour un dépôt

rdc repo autostart disable [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

list

Lister les dépôts avec le démarrage automatique activé

rdc repo autostart list [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.16 ownership

Changer la propriété du répertoire du dépôt

rdc repo ownership [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`--uid <uid>`	UID du propriétaire (par défaut : 7111)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.17 template

Appliquer un modèle à un dépôt

list

Lister tous les modèles de déploiement intégrés à la CLI

rdc repo template list

apply

Apply a template to a repository. Use a built-in template name (e.g. app-postgres) or --file for a custom JSON template. The template writes Rediaccfile, docker-compose.yml, and any additional files to the repository mount

rdc repo template apply [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine cible	Oui	-
`-r, --repository <name>`	Nom du dépôt (se connecte à l'environnement du dépôt)	Oui	-
`--file <path>`	Chemin vers le fichier de modèle JSON	Non	-
`--grand <name>`	Nom du grand dépôt (résolution automatique vers le GUID)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.18 push

Pousser un dépôt vers un distant (machine ou stockage). Omettre le nom pour pousser tous les dépôts. Le type de cible est détecté automatiquement depuis la configuration. Pour un transfert machine-à-machine, l'image chiffrée du dépôt est copiée avec le MÊME GUID — c'est une sauvegarde/migration, pas un fork. Pour créer un fork indépendant, utilisez d'abord 'repo fork', puis push. Utilisez --up pour déployer après le push

rdc repo push [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`--to <remote>`	Nom de la machine ou du stockage de destination (détecté automatiquement depuis la configuration)	Non	-
`--to-machine <machine>`	—	Non	-
`--provision <provider>`	Provisionner automatiquement la machine cible via le fournisseur cloud si elle n'existe pas	Non	-
`--checkpoint`	Créer un checkpoint CRIU avant la sauvegarde (capture l'état de la mémoire des processus pour la migration à chaud)	Non	-
`--force`	Forcer l'écrasement de la sauvegarde existante	Non	-
`--up`	Après l'envoi, monter et déployer le dépôt sur la machine cible	Non	-
`--tag <tag>`	Tag de déploiement pour le versionnage	Non	-
`-m, --machine <name>`	Nom de la machine	Oui	-
`-w, --watch`	Surveiller les modifications	Non	-
`--parallel`	Démarrer les dépôts simultanément	Non	-
`--concurrency <n>`	Nombre maximum de dépôts simultanés (par défaut : 3)	Non	`3`
`-y, --yes`	Passer la confirmation pour les opérations par lots	Non	-
`--bwlimit <limit>`	Limite de bande passante pour le transfert rsync (ex : "6M", "10M")	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.19 pull

Tirer un dépôt depuis un distant (machine ou stockage). Omettre le nom pour tirer tous les dépôts. Le type de source est détecté automatiquement depuis la configuration. Utilisez --up pour déployer après le pull

rdc repo pull [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Non	-
`--from <remote>`	Nom de la machine ou du stockage source (détecté automatiquement depuis la configuration)	Non	-
`--from-machine <machine>`	—	Non	-
`--force`	Forcer l'écrasement du dépôt existant	Non	-
`--up`	Après le pull, monter et déployer le dépôt sur cette machine	Non	-
`-m, --machine <name>`	Nom de la machine	Oui	-
`-w, --watch`	Surveiller les modifications	Non	-
`--parallel`	Démarrer les dépôts simultanément	Non	-
`--concurrency <n>`	Nombre maximum de dépôts simultanés (par défaut : 3)	Non	`3`
`-y, --yes`	Passer la confirmation pour les opérations par lots	Non	-
`--bwlimit <limit>`	Limite de bande passante pour le transfert rsync (ex : "6M", "10M")	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.20 migrate

Migration en direct d'un dépôt d'une machine à une autre avec un temps d'arrêt minimal. rsync en deux phases : transfert en masse pendant l'exécution, puis arrêt bref pour la synchronisation delta. Prend en charge le checkpoint CRIU pour la migration de la mémoire des processus et le provisionnement automatique des machines cibles

rdc repo migrate [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--from <machine>`	Nom de la machine source	Oui	-
`--to <machine>`	Nom de la machine cible	Oui	-
`--provision <provider>`	Provisionnement automatique de la cible via un fournisseur cloud (ex : hetzner, linode)	Non	-
`--bwlimit <limit>`	Limite de bande passante pour le transfert rsync (ex : 10M)	Non	-
`--checkpoint`	Migration en direct CRIU : capturer et restaurer l'état de la mémoire des processus	Non	-
`--skip-dns`	Ignorer le changement des enregistrements DNS après la migration	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

6.21 backup

Gérer les sauvegardes de dépôts

list

Lister les sauvegardes disponibles sur un distant (machine ou stockage)

rdc repo backup list [options]

Option	Libellé	Requis	Défaut
`--from <remote>`	Nom de la machine ou du stockage source (détecté automatiquement depuis la configuration)	Non	-
`--from-machine <machine>`	—	Non	-
`-m, --machine <name>`	Nom de la machine	Oui	-
`--path <subdir>`	Sous-répertoire dans la racine du stockage. Lorsqu'omis, hot/ et cold/ sont listés et fusionnés.	Non	-
`-w, --watch`	Surveiller les modifications	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

6.22 sync

Synchroniser les dépôts et fichiers (push/pull en masse, transfert de fichiers)

push

Envoyer les dépôts vers le stockage cloud (omettre le nom pour tout envoyer)

rdc repo sync push

pull

Récupérer les dépôts depuis le stockage cloud (omettre le nom pour tout récupérer)

rdc repo sync pull

upload

Envoyer des fichiers vers un dépôt

rdc repo sync upload [options]

Option	Libellé	Requis	Défaut
`-t, --team <name>`	Nom de l'équipe	Non	-
`-m, --machine <name>`	Nom de la machine	Oui	-
`-r, --repository <name>`	Nom du dépôt (se connecte à l'environnement du dépôt)	Non	-
`--local <paths...>`	Un ou plusieurs chemins locaux de fichier ou de répertoire (par défaut : répertoire actuel)	Non	-
`--remote <path>`	Chemin du sous-répertoire distant dans le dépôt	Non	-
`--remote-file <path>`	Chemin unique d'un fichier distant (relatif à la racine du dépôt) comme cible du téléversement. Mutuellement exclusif avec --remote.	Non	-
`--mirror`	Mode miroir - supprimer les fichiers distants non présents localement	Non	-
`--verify`	Vérifier les fichiers à l'aide de sommes de contrôle après synchronisation	Non	-
`--confirm`	Aperçu des modifications et demande de confirmation avant synchronisation	Non	-
`--exclude <patterns...>`	Motifs à exclure de la synchronisation	Non	-
`--dry-run`	Afficher les actions prévues sans effectuer de modifications	Non	-

download

Télécharger des fichiers depuis un dépôt

rdc repo sync download [options]

Option	Libellé	Requis	Défaut
`-t, --team <name>`	Nom de l'équipe	Non	-
`-m, --machine <name>`	Nom de la machine	Oui	-
`-r, --repository <name>`	Nom du dépôt (se connecte à l'environnement du dépôt)	Non	-
`--local <path>`	Chemin du répertoire local (par défaut : répertoire actuel)	Non	-
`--remote <path>`	Chemin du sous-répertoire distant dans le dépôt	Non	-
`--remote-file <path>`	Chemin d'un fichier distant dans le dépôt (alternative à --remote pour les transferts de fichier unique)	Non	-
`--mirror`	Mode miroir - supprimer les fichiers locaux non présents à distance	Non	-
`--verify`	Vérifier les fichiers à l'aide de sommes de contrôle après synchronisation	Non	-
`--confirm`	Aperçu des modifications et demande de confirmation avant synchronisation	Non	-
`--exclude <patterns...>`	Motifs à exclure de la synchronisation	Non	-
`--dry-run`	Afficher les actions prévues sans effectuer de modifications	Non	-

status

Vérifier l'état de synchronisation et comparer les fichiers locaux/distants

rdc repo sync status [options]

Option	Libellé	Requis	Défaut
`-t, --team <name>`	Nom de l'équipe	Non	-
`-m, --machine <name>`	Nom de la machine	Oui	-
`-r, --repository <name>`	Nom du dépôt (se connecte à l'environnement du dépôt)	Non	-
`--local <path>`	Chemin du répertoire local (par défaut : répertoire actuel)	Non	-
`--remote <path>`	Chemin du sous-répertoire distant dans le dépôt	Non	-
`--remote-file <path>`	Chemin d'un fichier distant dans le dépôt (alternative à --remote pour les transferts de fichier unique)	Non	-

6.23 snapshot

Gérer les instantanés BTRFS sur les machines distantes

create

Créer un instantané BTRFS d'un dépôt

rdc repo snapshot create

list

Lister les instantanés sur une machine distante

rdc repo snapshot list

delete

Supprimer un instantané d'une machine distante

rdc repo snapshot delete

6.24 tunnel

Créer un tunnel SSH de redirection de port vers le port d'un conteneur sur une machine distante. Détecte automatiquement le conteneur et le port lorsqu'il n'y a pas d'ambiguïté. Le tunnel reste ouvert jusqu'à ce que vous appuyiez sur Ctrl+C

rdc repo tunnel [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Non	-
`-r, --repository <name>`	Nom du dépôt (se connecte à l'environnement du dépôt)	Non	-
`-c, --container <name>`	Nom du conteneur (détecté automatiquement s'il n'y en a qu'un en cours d'exécution)	Non	-
`--port <port>`	Port du conteneur distant à rediriger	Non	-
`--local <port>`	Port local (par défaut identique au port distant)	Non	-

6.25 secret

Manage per-repo secrets injected at deploy time. Two modes: env (REDIACC_SECRET_<KEY> via compose ${VAR} interpolation) and file (host tmpfs at /var/run/rediacc/secrets/<networkId>/<KEY>, mounted via Docker compose `secrets:` block). Secrets never enter the encrypted LUKS image, so forks inherit none — externals see the fork as a different principal.

get

Read a single secret. Returns a redacted stub (`<redacted:secret>:<digest8>`) under agent context regardless of policy.

rdc repo secret get [options]

Option	Libellé	Requis	Défaut
`--name <repository>`	Nom du dépôt (p. ex. mail, mail:staging). Sans tag, défaut :latest.	Oui	-
`--key <KEY>`	Clé secrète en UPPER_SNAKE_CASE (max 64 caractères). Sera exposée comme REDIACC_SECRET_<KEY> pour le mode env ou /run/secrets/<key> dans les conteneurs pour le mode file.	Oui	-

list

Liste les clés et modes de secret (jamais les valeurs, jamais les digests).

rdc repo secret list [options]

Option	Libellé	Requis	Défaut
`--name <repository>`	Nom du dépôt (p. ex. mail, mail:staging). Sans tag, défaut :latest.	Oui	-

set

Définir ou écraser un secret. Les forks n'héritent pas ; définissez explicitement sur le fork. Dans un contexte d'agent, nécessite une correspondance de digest --current (style passwd).

rdc repo secret set [options]

Option	Libellé	Requis	Défaut
`--name <repository>`	Nom du dépôt (p. ex. mail, mail:staging). Sans tag, défaut :latest.	Oui	-
`--key <KEY>`	Clé secrète en UPPER_SNAKE_CASE (max 64 caractères). Sera exposée comme REDIACC_SECRET_<KEY> pour le mode env ou /run/secrets/<key> dans les conteneurs pour le mode file.	Oui	-
`--value <value>`	Valeur du secret. Passez `-` pour lire depuis stdin (évite l'exposition dans l'historique du shell).	Oui	-
`--mode <mode>`	Mode de livraison : 'env' (visible dans l'environnement du conteneur, docker inspect) ou 'file' (fichier tmpfs, jamais dans env). Défaut : file.	Non	`file`
`--current <value>`	SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write.	Non	-
`--rotate-secret`	Reconnaître la rotation ; ignorer la précondition --current (audité comme rotation). À utiliser lors d'une rotation intentionnelle sans vérifier la valeur précédente.	Non	-

unset

Supprime un secret. Dans un contexte d'agent, nécessite une correspondance de digest --current.

rdc repo secret unset [options]

Option	Libellé	Requis	Défaut
`--name <repository>`	Nom du dépôt (p. ex. mail, mail:staging). Sans tag, défaut :latest.	Oui	-
`--key <KEY>`	Clé secrète en UPPER_SNAKE_CASE (max 64 caractères). Sera exposée comme REDIACC_SECRET_<KEY> pour le mode env ou /run/secrets/<key> dans les conteneurs pour le mode file.	Oui	-
`--current <value>`	SHA-256 digest of the previous value (passwd-style precondition). Required for overwrite under agent context; optional for first-write.	Non	-
`--rotate-secret`	Reconnaître la rotation ; ignorer la précondition --current (audité comme rotation). À utiliser lors d'une rotation intentionnelle sans vérifier la valeur précédente.	Non	-

7. Gestion du Stockage

Gérer les fournisseurs de stockage et parcourir les fichiers distants

7.1 list

Lister les fournisseurs de stockage

rdc storage list [options]

Option	Libellé	Requis	Défaut
`-t, --team <name>`	Nom de l'équipe	Non	-
`--search <text>`	Rechercher dans {{field}}	Non	-
`--sort <field>`	Trier par champ	Non	-
`--desc`	Ordre décroissant	Non	-

7.2 create

Créer un nouveau fournisseur de stockage

rdc storage create [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-

7.3 rename

Renommer un fournisseur de stockage

rdc storage rename [options]

Option	Libellé	Requis	Défaut
`--current-name <name>`	Nom actuel de la ressource	Oui	-
`--new-name <name>`	Nouveau nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-

7.4 delete

Supprimer un fournisseur de stockage

rdc storage delete [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-t, --team <name>`	Nom de l'équipe	Non	-
`-f, --force`	Ignorer les invites de confirmation	Non	-
`--dry-run`	Afficher les actions prévues sans effectuer de modifications	Non	-

7.5 vault

Gestion du coffre-fort de stockage (adaptateur cloud uniquement)

rdc storage vault

7.6 browse

Parcourir les fichiers dans un système de stockage

rdc storage browse [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`--path <subpath>`	Chemin du sous-répertoire à lister	Non	“

7.7 prune

Supprimer les sauvegardes orphelines du stockage qui ne sont plus dans aucune configuration. Sécurisé multi-configuration avec protection par période de grâce.

rdc storage prune [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Machine exécutrice : exécute les appels list/delete de rclone vers le stockage. Requise car les clients ne sont pas censés avoir rclone installé localement ; les identifiants de stockage proviennent toujours de votre configuration locale.	Oui	-
`--dry-run`	Afficher les actions prévues sans effectuer de modifications	Non	-
`--force`	Ignorer les invites de confirmation	Non	-
`--force-delete-mounted`	Remplace la vérification de sécurité de montage et supprime les sauvegardes cloud même si le GUID source est actuellement monté ou a un conteneur en cours sur la machine exécutrice. Distinct de --force (qui ne remplace que la période de grâce pour les dépôts archivés).	Non	-
`--grace-days <days>`	Période de grâce en jours pour les dépôts récemment archivés (par défaut : 7)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-
`--skip-router-restart`	Ne pas redémarrer le serveur de routes après la mise à jour du binaire	Non	-

7.8 pull

Télécharger une sauvegarde depuis le stockage cloud vers une machine

rdc storage pull

8. Intégration VS Code

Ouvrir VS Code Remote SSH vers une machine ou un dépôt

8.1 connect

Se connecter à une machine ou un dépôt dans VS Code

rdc vscode connect [options]

Option	Libellé	Requis	Défaut
`-t, --team <name>`	Nom de l'équipe	Non	-
`-m, --machine <name>`	Nom de la machine	Non	-
`-r, --repository <name>`	Nom du dépôt (se connecte à l'environnement du dépôt)	Non	-
`-f, --folder <path>`	Chemin du dossier distant à ouvrir	Non	-
`--url-only`	Afficher l'URI VS Code au lieu de le lancer	Non	-
`-n, --new-window`	Ouvrir dans une nouvelle fenêtre VS Code	Non	-
`--skip-env-setup`	Ignorer la configuration de l'environnement distant	Non	-
`--insiders`	Utiliser les paramètres VS Code Insiders	Non	-

8.2 list

Lister les connexions SSH VS Code configurées

rdc vscode list

8.3 cleanup

Supprimer les configurations SSH VS Code

rdc vscode cleanup [options]

Option	Libellé	Requis	Défaut
`--all`	Supprimer toutes les configurations SSH rediacc	Non	-
`-c, --connection <name>`	Supprimer une connexion spécifique	Non	-

8.4 check

Vérifier l'installation et la configuration de VS Code

rdc vscode check [options]

Option	Libellé	Requis	Défaut
`--insiders`	Utiliser les paramètres VS Code Insiders	Non	-

9. Accès Terminal SSH

Accès terminal SSH aux machines et dépôts

9.1 connect

Se connecter à une machine ou un dépôt via SSH

rdc term connect [options]

Option	Libellé	Requis	Défaut
`-t, --team <name>`	Nom de l'équipe	Non	-
`-m, --machine <name>`	Nom de la machine	Non	-
`-r, --repository <name>`	Nom du dépôt (se connecte à l'environnement du dépôt)	Non	-
`-c, --command <cmd>`	Exécuter une commande au lieu d'un shell interactif	Non	-
`--container <id>`	Se connecter à un conteneur Docker spécifique	Non	-
`--container-action <action>`	Action du conteneur : terminal, logs, stats, exec	Non	-
`--log-lines <lines>`	Nombre de lignes de journaux à afficher (par défaut : 50)	Non	-
`--follow`	Suivre la sortie des journaux	Non	-
`--external`	Forcer le lancement dans une fenêtre de terminal externe	Non	-
`--reset-home`	Réinitialiser la couche de répertoire personnel par dépôt pour un nouveau départ	Non	-

10. Gestionnaire de Protocole

Enregistrer et gérer les URL du protocole {{scheme}}://

10.1 register

Enregistrer le gestionnaire de protocole sur le système

rdc protocol register [options]

Option	Libellé	Requis	Défaut
`--system`	Enregistrer au niveau du système (nécessite des privilèges administrateur)	Non	-
`--force`	Forcer la réinscription même si déjà enregistré	Non	-

10.2 unregister

Désinscrire le gestionnaire de protocole du système

rdc protocol unregister [options]

Option	Libellé	Requis	Défaut
`--system`	Désinscrire l'enregistrement au niveau du système (nécessite des privilèges administrateur)	Non	-

10.3 status

Afficher l'état d'enregistrement du gestionnaire de protocole

rdc protocol status

10.4 open

Ouvrir une URL {{scheme}}:// et exécuter l'action

rdc protocol open <url>

10.5 build

Construire une URL {{scheme}}:// à partir de composants

rdc protocol build [options]

Option	Libellé	Requis	Défaut
`--token <token>`	Jeton d'authentification	Oui	-
`-t, --team <name>`	Nom de l'équipe	Oui	-
`-m, --machine <name>`	Nom de la machine	Oui	-
`-r, --repository <name>`	Nom du dépôt (se connecte à l'environnement du dépôt)	Non	-
`-a, --action <action>`	Action à effectuer ({{actions}})	Non	`desktop`
`-p, --params <key=value...>`	Paramètres supplémentaires	Non	-

10.6 parse

Analyser une URL {{scheme}}:// et afficher les composants

rdc protocol parse <url>

11. Commandes Rapides (Raccourcis)

11.1 run

Exécuter une fonction (raccourci pour : queue create)

rdc run

11.2 trace

Tracer une tâche (raccourci pour : queue trace)

rdc trace

11.3 cancel

Annuler une tâche (raccourci pour : queue cancel)

rdc cancel

11.4 retry

Réessayer une tâche échouée (raccourci pour : queue retry)

rdc retry

12. Gestion des Abonnements

Gérer les licences machine et l’abonnement

S’authentifier avec un jeton API du portail web

rdc subscription login [options]

Option	Libellé	Requis	Défaut
`-t, --token <token>`	Jeton API (rdt_...)	Non	-
`--server <url>`	URL du serveur de compte	Non	-

12.2 logout

Supprimer le jeton d'abonnement stocké

rdc subscription logout

12.3 status

Afficher l’état de l’abonnement et de la licence

rdc subscription status

12.4 activation

Gestion de l'activation des machines

status

Afficher l'état d'activation d'une machine

rdc subscription activation status [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-

12.5 repo

Gestion des licences de dépôts

status

Afficher les licences de dépôts installées sur une machine

rdc subscription repo status [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-

12.6 refresh

Renouveler la licence de la machine

activation

Actualiser l'activation de la machine sur une machine distante

rdc subscription refresh activation [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-

repos

Actualiser les licences de dépôts par lots sur une machine distante

rdc subscription refresh repos [options]

Option	Libellé	Requis	Défaut
`-m, --machine <name>`	Nom de la machine	Oui	-

repo

Actualiser la licence du dépôt pour un dépôt spécifique

rdc subscription refresh repo [options]

Option	Libellé	Requis	Défaut
`--name <name>`	Nom de la ressource	Oui	-
`-m, --machine <name>`	Nom de la machine	Oui	-

13. Mises à jour CLI

Vérifier et appliquer les mises à jour du CLI

rdc update [options]

Option	Libellé	Requis	Défaut
`--force`	Forcer la mise à jour même si déjà à jour	Non	-
`--check-only`	Vérifier les mises à jour sans télécharger	Non	-
`--rollback`	Revenir à la version précédente	Non	-
`--status`	Afficher l'état et les diagnostics de la mise à jour automatique	Non	-
`--channel <channel>`	Définir le canal de publication (stable ou edge)	Non	-

14. Diagnostics système

Diagnostiquer l'environnement CLI et l'intégration renet

rdc doctor

15. Opérations VM Expérimentales

Opérations VM expérimentales (provisionner, gérer, détruire)

15.1 up

Provisionner un cluster VM localement

rdc ops up [options]

Option	Libellé	Requis	Défaut
`--force`	Forcer le redémarrage de toutes les VM	Non	-
`--parallel`	Créer les VM en parallèle	Non	-
`--basic`	Cluster minimal (pont + 1 worker)	Non	-
`--lite`	Ignorer le provisionnement des VM (statut uniquement)	Non	-
`--skip-orchestration`	Ignorer l'orchestration du cluster	Non	-
`--backend <backend>`	Backend de virtualisation (kvm\|qemu, détection automatique)	Non	-
`--os <name>`	Système d'exploitation de la VM (ex. ubuntu-24.04, debian-12)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

15.2 down

Détruire le cluster VM

rdc ops down [options]

Option	Libellé	Requis	Défaut
`--backend <backend>`	Backend de virtualisation (kvm\|qemu, détection automatique)	Non	-
`--debug`	Activer la sortie de débogage (mode local)	Non	-

15.3 status

Afficher l'état du cluster VM

rdc ops status [options]

Option	Libellé	Requis	Défaut
`--backend <backend>`	Backend de virtualisation (kvm\|qemu, détection automatique)	Non	-

15.4 ssh

Se connecter en SSH à une VM

rdc ops ssh [options]

Option	Libellé	Requis	Défaut
`--vm-id <id>`	ID de la machine virtuelle	Oui	-
`-c, --command <cmd>`	Exécuter une commande au lieu d'un shell interactif	Non	-
`--backend <backend>`	Backend de virtualisation (kvm\|qemu, détection automatique)	Non	-
`--user <user>`	Nom d'utilisateur SSH pour la connexion à la VM	Non	-

15.5 setup

Installer les prérequis de virtualisation

rdc ops setup [options]

Option	Libellé	Requis	Défaut
`--debug`	Activer la sortie de débogage (mode local)	Non	-

15.6 check

Vérifier les prérequis de virtualisation

rdc ops check

Messages d'Erreur Courants

Lorsque quelque chose ne va pas, la CLI fournit des messages d'erreur clairs :

Erreur	Signification
L'authentification est requise. Exécutez : rdc auth login	Vous devez d'abord vous connecter
Aucune configuration active. Créez-en une avec : rdc config init --name <name>	Aucune configuration active — créez-en une avec `rdc config init`
Permission refusée	Votre compte ne dispose pas des permissions requises
Le nom de la machine est requis. Utilisez --machine <name>	Spécifiez une machine avec `--machine` ou définissez un défaut de contexte
Le nom de l'équipe est requis. Utilisez --team ou définissez un contexte.	Spécifiez une équipe avec `--team` ou définissez un défaut de contexte
Le nom de la région est requis. Utilisez --region ou définissez un contexte.	Spécifiez une région avec `--region` ou définissez un défaut de contexte

Formats de Sortie

Toutes les commandes list/get prennent en charge plusieurs formats de sortie via `--output` :

rdc machine list --output json
rdc machine list --output yaml
rdc machine list --output csv
rdc machine list --output table   # default

Cela facilite l'intégration de la CLI Rediacc dans les scripts, les pipelines CI/CD et les workflows d'automatisation.