Bedrud Dokumentation

Ein-Klick-Installation für alle Plattformen. Kein sudo — wird in Ihrem Home-Verzeichnis installiert.

Für die Server-Einrichtung nach der Installation siehe Schnellstart. Für Paketmanager, Docker und andere Methoden siehe Serverinstallation.


Funktionsweise

  1. Erkennt Betriebssystem, CPU-Architektur und Plattformvarianten (Rosetta 2)
  2. Lädt die richtige Binärdatei von GitHub Releases herunter
  3. Installiert nach ~/bin (anpassbar über --install-dir)
  4. Fügt das Installationsverzeichnis über die Shell-Konfiguration zum PATH hinzu
  5. Führt bedrud completions für Shell-Tab-Vervollständigung aus
  6. Zeigt die nächsten Schritte an

Voraussetzungen

PlattformAbhängigkeiten
macOS / Linuxcurl + tar
WindowsPowerShell 5.1+ (in Windows 10/11 enthalten)

Schnellinstallation

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

Shell neu laden, dann überprüfen:

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

Flags & Optionen

Bash-Installer

Usage: curl -fsSL https://get.bedrud.org | bash -s -- [options]
FlagStandardBeschreibung
--install-dir <dir>~/binAblageort der Binärdatei
--version <ver>latestEine Release-Version festlegen (z. B. v1.2.0)
--skip-shelloffShell-RC-Dateien und PATH nicht ändern
-h, --helpVerwendung anzeigen und beenden

Beispiele:

# Standard
curl -fsSL https://get.bedrud.org | bash
 
# Version festlegen
curl -fsSL https://get.bedrud.org | bash -s -- --version v1.2.0
 
# Systemweite Installation
curl -fsSL https://get.bedrud.org | sudo bash -s -- --install-dir /usr/local/bin
 
# CI / Automatisierung — Shell-Konfiguration überspringen
curl -fsSL https://get.bedrud.org | bash -s -- --skip-shell

PowerShell-Installer

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

Zum Übergeben von Parametern zunächst in einer Datei speichern:

irm https://get.bedrud.org/install.ps1 -OutFile install.ps1
.\install.ps1 -Version v1.2.0 -InstallDir C:\Tools
ParameterStandardBeschreibung
-InstallDir <path>$HOME\binAblageort von bedrud.exe
-Version <ver>latestEine bestimmte Release-Version installieren
-SkipPath$falseInstallationsverzeichnis nicht zum Benutzer-PATH hinzufügen

Umgebungsvariablen

VariableStandardPlattformenBeschreibung
BEDRUD_INSTALL~/binNur BashInstallationsverzeichnis überschreiben (gleich wie --install-dir)
BEDRUD_REPObedrud-ir/bedrudBeideGitHub-Repo überschreiben (für Forks oder Mirrors)
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

Plattformunterstützung

ZielBetriebssystemArchitekturHinweise
darwin_amd64macOSIntel (x86_64)Standard
darwin_arm64macOSApple Silicon (M1/M2/M3/M4)Rosetta 2 automatisch erkannt
linux_amd64Linuxx86_64Standard
linux_arm64LinuxARM64Standard
freebsd_amd64FreeBSDx86_64Standard
windows_amd64Windowsx86_64Standard
windows_arm64WindowsARM64Standard
Logik zur Erkennung von Betriebssystem und Architektur
uname -s → "Darwin"  → darwin
           "Linux"   → linux
           "FreeBSD" → freebsd
           "MINGW*"  → Weiterleitung zum PowerShell-Skript
           "MSYS*"   → Weiterleitung zum PowerShell-Skript

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

Erkennung von Sonderfällen

Rosetta 2 (macOS Intel auf Apple Silicon)

Erkennung: sysctl -n sysctl.proc_translated gibt 1 zurück. Auswirkung: Wechselt darwin_amd64darwin_arm64 für native ARM-Leistung.


Installationsablauf

  1. Windows-Prüfung — MINGW/MSYS/CYGWIN erkannt? PowerShell-Befehl anzeigen, beenden
  2. Abhängigkeitsprüfung — erfordert curl + tar
  3. Argumentauswertung — maximal 3 Flags
  4. Plattform-Erkennung — Betriebssystem + Architektur über uname
  5. Varianten-Erkennung — Rosetta 2
  6. Downloadbedrud_{TARGET}.tar.xz herunterladen
  7. Extrahieren & Installieren — Temp-Verzeichnis, entpacken, mv → $INSTALL_DIR/bedrud, chmod +x
  8. Überprüfenbedrud --version ausführen
  9. PATH-Prüfung — bereits im PATH? Überspringen. --skip-shell? Manuellen Befehl anzeigen. Sonst → RC-Datei ändern
  10. Vervollständigungenbedrud completions ausführen
  11. Fertig — Erfolgsmeldung + Neulade-Anweisungen anzeigen

Download-URL-Format: github.com/{repo}/releases/{ver}/bedrud_{TARGET}.tar.xz


PATH & Shell-Konfiguration

Wenn --skip-shell nicht gesetzt ist, fügt das Installationsprogramm das Installationsverzeichnis Ihrem PATH hinzu.

ShellRC-Datei
fish~/.config/fish/config.fish
zsh$ZDOTDIR/.zshrc (Standard ~/.zshrc)
bash (macOS)~/.bash_profile, dann ~/.bashrc
bash (Linux)~/.bashrc, dann ~/.bash_profile

Was hinzugefügt wird:

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

Der # bedrud-Kommentar-Marker verhindert doppelte Einträge — sicher zum erneuten Ausführen.

Windows: Verwendet [Environment]::SetEnvironmentVariable("PATH", ..., "User") auf Registrierungsebene. Keine RC-Datei erforderlich.

Shell nach der Installation neu laden:

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

Offline- / Air-Gap-Installationen

Herunterladen und Übertragen

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/
# Auf dem Zielsystem:
tar -xf /tmp/bedrud.tar.xz -C /tmp/bedrud-extracted
mv /tmp/bedrud-extracted/bedrud ~/bin/
chmod +x ~/bin/bedrud

Selbstgehosteter Mirror

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

Direkte Binärdatei

Von Releases herunterladen, entpacken und in ein Verzeichnis in Ihrem PATH verschieben.


Deinstallation

rm ~/bin/bedrud
# PATH-Zeile aus der Shell-RC entfernen (nach "# bedrud" suchen):
#   ~/.bashrc, ~/.bash_profile, ~/.zshrc, ~/.config/fish/config.fish

Für systemd-Serverinstallationen:

sudo bedrud uninstall

Windows:

Remove-Item "$env:USERPROFILE\bin\bedrud.exe"
# Über Systemeigenschaften → Umgebungsvariablen aus dem PATH entfernen

Fehlerbehebung

command not found: bedrud

source ~/.bashrc    # Shell neu laden
echo $PATH | tr ':' '\n' | grep "$HOME/bin"  # PATH prüfen

Falls fehlend:

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

Failed to download bedrud

  1. Internetverbindung prüfen
  2. Überprüfen, ob das Ziel unter Releases existiert
  3. Eine bestimmte Version versuchen: --version v1.0.0
  4. Ihre Plattform verfügt möglicherweise noch nicht über eine vorkompilierte Binärdatei

macOS: x64 wird unter Rosetta ausgeführt (langsam)

Natives ARM erzwingen:

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

Windows: „Ausführung von Skripts ist deaktiviert”

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