Esta guía cubre la instalación del servidor Bedrud (API, interfaz web, servidor de medios WebRTC) en un servidor Linux. Para las aplicaciones cliente de escritorio y móvil, consulta Instalación del Cliente.

Requisitos Previos

¿Sin dominio? Bedrud funciona con una dirección IP usando TLS autofirmado. Los navegadores mostrarán una advertencia de certificado pero el video y el audio funcionan. Para certificados de confianza en redes internas, consulta la Guía de TLS Interno.

1. Instalación en un solo comando (Recomendado)

Descarga e instala el binario CLI de Bedrud en tu PATH. Funciona en Linux, macOS y Windows.

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

source ~/.bashrc  # o ~/.zshrc

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

Verifica:

bedrud --version

2. Instalación mediante Gestor de Paquetes

Instala a través del gestor de paquetes de tu distribución.

curl -fsSL https://bedrud-ir.github.io/bedrud/bedrud.gpg.key \
  | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/bedrud.gpg
 
echo "deb https://bedrud-ir.github.io/bedrud stable main" \
  | sudo tee /etc/apt/sources.list.d/bedrud.list
 
sudo apt update && sudo apt install bedrud

sudo bedrud install

yay -S bedrud-bin
sudo bedrud install

sudo curl -fsSL https://bedrud-ir.github.io/bedrud/dnf/bedrud.gpg.key \
  -o /etc/pki/rpm-gpg/RPM-GPG-KEY-bedrud
 
sudo curl -fsSL https://bedrud-ir.github.io/bedrud/dnf/bedrud.repo \
  -o /etc/yum.repos.d/bedrud.repo
 
sudo dnf install bedrud
sudo bedrud install

3. Docker

Ejecuta Bedrud en un contenedor: sin configuración de servidor Linux, sin systemd, sin descarga de binario.

Imagen Precompilada (lo más rápido)

docker pull ghcr.io/bedrud-ir/bedrud:latest
 
docker run -d --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -p 50000-60000:50000-60000/udp \
  -v bedrud-data:/var/lib/bedrud \
  ghcr.io/bedrud-ir/bedrud:latest

Docker Compose

services:
  bedrud:
    image: ghcr.io/bedrud-ir/bedrud:latest
    ports:
      - "8090:8090"
      - "7880:7880"
      - "50000-60000:50000-60000/udp"
    volumes:
      - bedrud-data:/var/lib/bedrud
    restart: unless-stopped
 
volumes:
  bedrud-data:

Puertos

Configuración

Pasa un archivo de configuración o usa variables de entorno:

docker run -d --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -e JWT_SECRET=change-this-to-a-random-string \
  -e LIVEKIT_API_KEY=prodkey \
  -e LIVEKIT_API_SECRET=prodsecret \
  -v bedrud-data:/var/lib/bedrud \
  ghcr.io/bedrud-ir/bedrud:latest

Documentación completa de Docker incluyendo volúmenes, proxy inverso y configuración TLS: Guía de Docker.

4. Instalación Interactiva

Si ya tienes el binario bedrud en el servidor:

sudo ./bedrud install

El instalador detecta automáticamente la IP del servidor y solicita:

Todos los indicadores se omiten cuando stdin se redirige (modo no interactivo); en su lugar se usan flags y valores predeterminados.

5. No Interactiva (mediante Flags)

Omite todos los indicadores pasando flags.

Let’s Encrypt (requiere dominio)

Requiere: El registro DNS A de tu dominio ya apuntando a la IP de este servidor.

sudo ./bedrud install --tls --domain meet.example.com --email webmaster@example.com

TLS Autofirmado (basado en IP)

Requiere: Nada adicional. Funciona inmediatamente.

sudo ./bedrud install --tls --ip 1.2.3.4

HTTP Simple (solo desarrollo / interno)

Requiere: localhost o 127.0.0.1. Los navegadores bloquean cámara/micrófono en sitios no HTTPS excepto localhost.

sudo ./bedrud install --ip 1.2.3.4

Autofirmado para un Dominio (pruebas previas a DNS)

Requiere: Nombre de dominio (DNS no necesita resolverse aún).

sudo ./bedrud install --tls --domain meet.example.com

Puerto Personalizado

Requiere: Puerto que no esté en uso.

sudo ./bedrud install --tls --port 8443 --domain meet.example.com

Certificados Externos

Requiere: Archivos de fullchain y clave privada en formato PEM.

sudo ./bedrud install --tls --cert /path/to/fullchain.pem --key /path/to/privkey.pem

Puertos Personalizados de LiveKit

Requiere: Los tres puertos abiertos en tu firewall.

sudo ./bedrud install --lk-port 9000 --lk-tcp-port 9001 --lk-udp-port 9002

Detrás de un Proxy Inverso

Requiere: Un proxy inverso (Nginx, Caddy, Traefik, Cloudflare) terminando TLS delante de Bedrud.

sudo ./bedrud install --behind-proxy --domain meet.example.com

Establece behindProxy: true en la configuración y configura los headers de proxy de confianza.

Servidor LiveKit Externo

Requiere: Un servidor LiveKit separado ya en ejecución, accesible desde esta máquina.

sudo ./bedrud install --external-livekit https://livekit.example.com

Omite la instalación de LiveKit integrado. La API key y el secret deben coincidir en ambas configuraciones.

Dominio Separado para LiveKit

Requiere: Un dominio que resuelva directamente a este servidor, evitando cualquier CDN.

sudo ./bedrud install --livekit-domain lk.example.com --domain meet.example.com

Útil cuando el dominio principal está detrás de Cloudflare pero los medios WebRTC necesitan una conexión directa.

Referencia Completa de Flags

6. Totalmente Automatizada (CLI de Python)

Compila, sube y configura tu servidor desde tu máquina local.

Requiere: Python 3.12+, uv (ejecutor de paquetes Python), acceso por clave SSH al servidor de destino, Go 1.24+ y Bun instalados localmente.

cd tools/cli
uv run python bedrud.py --auto-config \
  --ip <tu-ip-del-servidor> \
  --user root \
  --auth-key ~/.ssh/id_rsa \
  --domain meet.example.com \
  --acme-email admin@example.com

Lo que hace:

1. Compila el binario del backend (dist/bedrud)
2. Lo comprime en bedrud.tar.xz
3. Lo sube al servidor vía rsync
4. Limpia servicios en conflicto (Nginx, Apache, Caddy)
5. Configura el firewall (UFW)
6. Ejecuta la lógica de install interna en el servidor

Puntos de Entrada de Servicio

bedrud --run --config /etc/bedrud/config.yaml       # API + servidor web
bedrud --livekit --config /etc/bedrud/livekit.yaml   # Servidor de medios

Post-Instalación

			
sudo ./bedrud user promote --email admin@example.com
		

Verificar los Servicios

systemctl status bedrud livekit

Verificar la API

curl -s -o /dev/null -w "%{http_code}" http://localhost:8090

Esperado: 200

Verificar el Firewall

sudo ufw status

Asegúrate de que los puertos 8090/tcp, 7880/tcp y 50000:60000/udp estén permitidos:

sudo ufw allow 8090/tcp
sudo ufw allow 7880/tcp
sudo ufw allow 50000:60000/udp

Ver Registros

tail -f /var/log/bedrud/bedrud.log

O vía journalctl:

journalctl -u bedrud -u livekit -f

Actualización

Gestor de Paquetes

# Ubuntu / Debian
sudo apt update && sudo apt upgrade bedrud
 
# Arch Linux
yay -Syu bedrud-bin
 
# Fedora / RHEL
sudo dnf upgrade bedrud

Los servicios se reinician automáticamente después de la actualización del paquete.

Descarga de Binario

Descarga la última versión y vuelve a ejecutar la instalación. El instalador es seguro para re-ejecutarse: sobrescribe el binario y la configuración preservando la base de datos:

curl -fsSL -o bedrud.tar.xz https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_linux_amd64.tar.xz
tar -xJf bedrud.tar.xz && chmod +x bedrud
sudo ./bedrud install --fresh

Docker

docker pull ghcr.io/bedrud-ir/bedrud:latest
docker stop bedrud && docker rm bedrud
docker run -d --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -p 50000-60000:50000-60000/udp \
  -v bedrud-data:/var/lib/bedrud \
  ghcr.io/bedrud-ir/bedrud:latest

Con Docker Compose:

docker compose pull
docker compose up -d

Desinstalación

Para eliminar Bedrud por completo:

sudo bedrud uninstall

Esto detiene los servicios, elimina las unidades systemd, borra el binario de /usr/local/bin y limpia /etc/bedrud, /var/lib/bedrud y /var/log/bedrud.

Solución de Problemas