Bedrud Documentation

Installation en une commande sur toutes les plateformes. Pas besoin de sudo — s’installe dans votre répertoire personnel.

Pour la configuration du serveur après l’installation, voir Démarrage rapide. Pour les gestionnaires de packages, Docker et autres méthodes, voir Installation du serveur.


Ce qu’il fait

  1. Détecte l’OS, l’architecture CPU et les variantes de plateforme (Rosetta 2)
  2. Télécharge le bon binaire depuis GitHub Releases
  3. Installe dans ~/bin (personnalisable via --install-dir)
  4. Ajoute le répertoire d’installation au PATH via la configuration du shell
  5. Exécute bedrud completions pour la complétion par tabulation du shell
  6. Affiche les prochaines étapes

Prérequis

PlateformeDépendances
macOS / Linuxcurl + tar
WindowsPowerShell 5.1+ (inclus avec Windows 10/11)

Installation rapide

curl -fsSL https://get.bedrud.org | bash

Rechargez votre shell, puis vérifiez :

source ~/.bashrc  # ou ~/.zshrc
bedrud --version
irm https://get.bedrud.org/install.ps1 | iex
bedrud --version

Flags et options

Installateur Bash

Usage: curl -fsSL https://get.bedrud.org | bash -s -- [options]
FlagPar défautDescription
--install-dir <dir>~/binOù placer le binaire
--version <ver>latestÉpingler à une version (ex. v1.2.0)
--skip-shellinactifNe pas modifier les fichiers RC du shell ni le PATH
-h, --helpAfficher l’aide et quitter

Exemples :

# Par défaut
curl -fsSL https://get.bedrud.org | bash
 
# Version spécifique
curl -fsSL https://get.bedrud.org | bash -s -- --version v1.2.0
 
# Installation système
curl -fsSL https://get.bedrud.org | sudo bash -s -- --install-dir /usr/local/bin
 
# CI / automatisation — ignorer la config du shell
curl -fsSL https://get.bedrud.org | bash -s -- --skip-shell

Installateur PowerShell

Usage: irm https://get.bedrud.org/install.ps1 | iex

Pour passer des paramètres, enregistrez d’abord le fichier :

irm https://get.bedrud.org/install.ps1 -OutFile install.ps1
.\install.ps1 -Version v1.2.0 -InstallDir C:\Tools
ParamètrePar défautDescription
-InstallDir <path>$HOME\binOù placer bedrud.exe
-Version <ver>latestInstaller une version spécifique
-SkipPath$falseNe pas ajouter le répertoire au PATH utilisateur

Variables d’environnement

VariablePar défautPlateformesDescription
BEDRUD_INSTALL~/binBash uniquementRemplacer le répertoire d’installation (identique à --install-dir)
BEDRUD_REPObedrud-ir/bedrudLes deuxRemplacer le dépôt GitHub (pour les forks ou miroirs)
BEDRUD_INSTALL=/opt/bedrud curl -fsSL https://get.bedrud.org | bash
BEDRUD_REPO=myorg/bedrud-fork curl -fsSL https://get.bedrud.org | bash
$env:BEDRUD_REPO = "myorg/bedrud-fork"
irm https://get.bedrud.org/install.ps1 | iex

Plateformes supportées

CibleOSArchitectureNotes
darwin_amd64macOSIntel (x86_64)Standard
darwin_arm64macOSApple Silicon (M1/M2/M3/M4)Rosetta 2 détecté automatiquement
linux_amd64Linuxx86_64Standard
linux_arm64LinuxARM64Standard
freebsd_amd64FreeBSDx86_64Standard
windows_amd64Windowsx86_64Standard
windows_arm64WindowsARM64Standard
Logique de détection de l’OS et de l’architecture
uname -s → "Darwin"  → darwin
           "Linux"   → linux
           "FreeBSD" → freebsd
           "MINGW*"  → redirection vers le script PowerShell
           "MSYS*"   → redirection vers le script PowerShell

uname -m → "x86_64" | "amd64"  → amd64
           "aarch64" | "arm64"  → arm64

Détection des cas particuliers

Rosetta 2 (macOS Intel sur Apple Silicon)

Détection : sysctl -n sysctl.proc_translated renvoie 1. Effet : Bascule darwin_amd64darwin_arm64 pour les performances ARM natives.


Processus d’installation

  1. Vérification Windows — MINGW/MSYS/CYGWIN détecté ? Afficher la commande PowerShell, quitter
  2. Vérification des dépendances — nécessite curl + tar
  3. Analyse des arguments — max 3 flags
  4. Détection de plateforme — OS + architecture via uname
  5. Détection des variantes — Rosetta 2
  6. Téléchargement — télécharge bedrud_{TARGET}.tar.xz
  7. Extraction et installation — répertoire temporaire, extraction, mv → $INSTALL_DIR/bedrud, chmod +x
  8. Vérification — exécuter bedrud --version
  9. Vérification du PATH — déjà dans le PATH ? Ignorer. --skip-shell ? Afficher la commande manuelle. Sinon → modifier le fichier RC
  10. Complétions — exécuter bedrud completions
  11. Terminé — afficher le succès + instructions de rechargement

Format de l’URL de téléchargement : github.com/{repo}/releases/{ver}/bedrud_{TARGET}.tar.xz


PATH et configuration du shell

Quand --skip-shell n’est pas défini, l’installateur ajoute le répertoire d’installation à votre PATH.

ShellFichier RC
fish~/.config/fish/config.fish
zsh$ZDOTDIR/.zshrc (par défaut ~/.zshrc)
bash (macOS)~/.bash_profile, puis ~/.bashrc
bash (Linux)~/.bashrc, puis ~/.bash_profile

Ce qui est ajouté :

# bedrud
export PATH="$HOME/bin:$PATH"  # bedrud

Le marqueur de commentaire # bedrud empêche les entrées en double — il est sans risque de relancer.

Windows : Utilise [Environment]::SetEnvironmentVariable("PATH", ..., "User") au niveau du registre. Pas besoin de fichier RC.

Rechargez le shell après l’installation :

source ~/.bashrc    # bash
source ~/.zshrc     # zsh
source ~/.config/fish/config.fish  # fish

Installations hors ligne / isolées

Téléchargement et transfert

curl -fsSL -o bedrud.tar.xz \
  https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_linux_amd64.tar.xz
scp bedrud.tar.xz airgapped-server:/tmp/
# Sur la cible :
tar -xf /tmp/bedrud.tar.xz -C /tmp/bedrud-extracted
mv /tmp/bedrud-extracted/bedrud ~/bin/
chmod +x ~/bin/bedrud

Miroir auto-hébergé

BEDRUD_REPO=mycompany/bedrud-mirror curl -fsSL https://get.bedrud.org | bash

Binaire direct

Téléchargez depuis Releases, extrayez, déplacez dans un répertoire de votre PATH.


Désinstallation

rm ~/bin/bedrud
# Supprimer la ligne PATH du fichier RC du shell (chercher "# bedrud") :
#   ~/.bashrc, ~/.bash_profile, ~/.zshrc, ~/.config/fish/config.fish

Pour les installations serveur avec systemd :

sudo bedrud uninstall

Windows :

Remove-Item "$env:USERPROFILE\bin\bedrud.exe"
# Supprimer du PATH via Propriétés système → Variables d'environnement

Dépannage

command not found: bedrud

source ~/.bashrc    # recharger le shell
echo $PATH | tr ':' '\n' | grep "$HOME/bin"  # vérifier le PATH

Si absent :

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Failed to download bedrud

  1. Vérifiez la connexion Internet
  2. Vérifiez que la cible existe sur Releases
  3. Essayez une version spécifique : --version v1.0.0
  4. Votre plateforme n’a peut-être pas encore de binaire précompilé

macOS : exécution x64 sous Rosetta (lent)

Forcer l’ARM natif :

arch -arm64 curl -fsSL https://get.bedrud.org | arch -arm64 bash

Windows : « running scripts is disabled »

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
irm https://get.bedrud.org/install.ps1 | iex