Bedrud Documentación

Instalación en un solo comando para todas las plataformas. No requiere sudo — instala en tu directorio personal.

Para la configuración del servidor después de la instalación, consulta Inicio Rápido. Para gestores de paquetes, Docker y otros métodos, consulta Instalación del Servidor.


Lo que Hace

  1. Detecta el sistema operativo, arquitectura de CPU y variantes de plataforma (Rosetta 2)
  2. Descarga el binario correcto desde GitHub Releases
  3. Instala en ~/bin (personalizable con --install-dir)
  4. Añade el directorio de instalación al PATH mediante la configuración del shell
  5. Ejecuta bedrud completions para el autocompletado por tabulador del shell
  6. Muestra los siguientes pasos

Requisitos

PlataformaDependencias
macOS / Linuxcurl + tar
WindowsPowerShell 5.1+ (incluido con Windows 10/11)

Instalación Rápida

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

Recarga el shell, luego verifica:

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

Flags y Opciones

Instalador Bash

Usage: curl -fsSL https://get.bedrud.org | bash -s -- [options]
FlagPredeterminadoDescripción
--install-dir <dir>~/binDónde colocar el binario
--version <ver>latestFijar a una versión (ej. v1.2.0)
--skip-shelldesactivadoNo modificar archivos RC del shell ni PATH
-h, --helpMostrar uso y salir

Ejemplos:

# Predeterminado
curl -fsSL https://get.bedrud.org | bash
 
# Fijar versión
curl -fsSL https://get.bedrud.org | bash -s -- --version v1.2.0
 
# Instalación en todo el sistema
curl -fsSL https://get.bedrud.org | sudo bash -s -- --install-dir /usr/local/bin
 
# CI / automatización — omitir configuración del shell
curl -fsSL https://get.bedrud.org | bash -s -- --skip-shell

Instalador PowerShell

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

Para pasar parámetros, guarda primero en un archivo:

irm https://get.bedrud.org/install.ps1 -OutFile install.ps1
.\install.ps1 -Version v1.2.0 -InstallDir C:\Tools
ParámetroPredeterminadoDescripción
-InstallDir <path>$HOME\binDónde colocar bedrud.exe
-Version <ver>latestInstalar una versión específica
-SkipPath$falseNo añadir el directorio de instalación al PATH del usuario

Variables de Entorno

VariablePredeterminadoPlataformasDescripción
BEDRUD_INSTALL~/binSolo BashSobrescribir directorio de instalación (igual que --install-dir)
BEDRUD_REPObedrud-ir/bedrudAmbasSobrescribir repositorio de GitHub (para forks o 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

Soporte de Plataformas

DestinoSOArquitecturaNotas
darwin_amd64macOSIntel (x86_64)Estándar
darwin_arm64macOSApple Silicon (M1/M2/M3/M4)Rosetta 2 detectado automáticamente
linux_amd64Linuxx86_64Estándar
linux_arm64LinuxARM64Estándar
freebsd_amd64FreeBSDx86_64Estándar
windows_amd64Windowsx86_64Estándar
windows_arm64WindowsARM64Estándar
Lógica de detección de SO y arquitectura
uname -s → "Darwin"  → darwin
           "Linux"   → linux
           "FreeBSD" → freebsd
           "MINGW*"  → redirigir al script de PowerShell
           "MSYS*"   → redirigir al script de PowerShell

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

Detección de Casos Especiales

Rosetta 2 (macOS Intel en Apple Silicon)

Detección: sysctl -n sysctl.proc_translated devuelve 1. Efecto: Cambia darwin_amd64darwin_arm64 para rendimiento nativo en ARM.


Flujo de Instalación

  1. Comprobación de Windows — ¿MINGW/MSYS/CYGWIN detectado? Mostrar comando de PowerShell, salir
  2. Comprobación de dependencias — requiere curl + tar
  3. Análisis de argumentos — máximo 3 flags
  4. Detección de plataforma — SO + arquitectura mediante uname
  5. Detección de variantes — Rosetta 2
  6. Descarga — descargar bedrud_{TARGET}.tar.xz
  7. Extracción e instalación — directorio temporal, extraer, mv → $INSTALL_DIR/bedrud, chmod +x
  8. Verificación — ejecutar bedrud --version
  9. Comprobación de PATH — ¿Ya en PATH? Omitir. ¿--skip-shell? Mostrar comando manual. En caso contrario → modificar archivo RC
  10. Completions — ejecutar bedrud completions
  11. Listo — mostrar éxito + instrucciones de recarga

Formato de URL de descarga: github.com/{repo}/releases/{ver}/bedrud_{TARGET}.tar.xz


PATH y Configuración del Shell

Cuando no se establece --skip-shell, el instalador añade el directorio de instalación a tu PATH.

ShellArchivo RC
fish~/.config/fish/config.fish
zsh$ZDOTDIR/.zshrc (predeterminado ~/.zshrc)
bash (macOS)~/.bash_profile, luego ~/.bashrc
bash (Linux)~/.bashrc, luego ~/.bash_profile

Lo que se añade:

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

El marcador de comentario # bedrud evita entradas duplicadas — es seguro volver a ejecutar.

Windows: Usa [Environment]::SetEnvironmentVariable("PATH", ..., "User") a nivel del registro. No se necesita archivo RC.

Recargar el shell después de la instalación:

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

Instalaciones Sin Conexión / Aisladas

Descargar y Transferir

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

Mirror Autohospedado

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

Binario Directo

Descarga desde Releases, extrae, mueve a un directorio en tu PATH.


Desinstalación

rm ~/bin/bedrud
# Eliminar la línea del PATH del archivo RC del shell (buscar "# bedrud"):
#   ~/.bashrc, ~/.bash_profile, ~/.zshrc, ~/.config/fish/config.fish

Para instalaciones de servidor con systemd:

sudo bedrud uninstall

Windows:

Remove-Item "$env:USERPROFILE\bin\bedrud.exe"
# Eliminar del PATH mediante Propiedades del Sistema → Variables de Entorno

Solución de Problemas

command not found: bedrud

source ~/.bashrc    # recargar el shell
echo $PATH | tr ':' '\n' | grep "$HOME/bin"  # verificar PATH

Si falta:

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

Failed to download bedrud

  1. Verifica la conexión a internet
  2. Comprueba que el destino existe en Releases
  3. Prueba una versión específica: --version v1.0.0
  4. Es posible que tu plataforma aún no tenga un binario precompilado

macOS: Ejecutando x64 bajo Rosetta (lento)

Forzar ARM nativo:

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