Esta guía explica cómo desplegar Bedrud en un servidor de producción.

Opciones de despliegue

Gestor de paquetes

Instala Bedrud en Debian/Ubuntu o Arch Linux usando el gestor de paquetes nativo. Este es el método recomendado para despliegues de servidor persistentes donde quieres actualizaciones automáticas mediante apt upgrade o AUR.

Consulta la guía de instalación por paquetes para instrucciones completas, incluyendo cómo añadir la clave GPG y el repositorio de apt.

# Ubuntu / Debian
sudo apt install bedrud
 
# Arch Linux (AUR)
yay -S bedrud-bin

Después de la instalación, ejecuta el instalador interactivo para configurar TLS, servicios systemd y la base de datos:

sudo bedrud install

Despliegue automatizado con CLI

La forma más rápida de desplegar. Ejecuta desde tu máquina local:

Requisitos previos: Python 3.10+, uv y acceso SSH al servidor de destino.

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

Esto hará lo siguiente:

1. Compilar el binario del backend localmente
2. Comprimir y subirlo mediante rsync
3. Limpiar servidores web conflictivos
4. Configurar el firewall
5. Instalar e iniciar los servicios en el servidor

Opciones de CLI

Instalación manual

1. Compilar el binario

make build-dist

Esto genera dist/bedrud_linux_amd64.tar.xz.

2. Subir al servidor

scp dist/bedrud_linux_amd64.tar.xz root@server:/tmp/
ssh root@server "cd /tmp && tar xf bedrud_linux_amd64.tar.xz"

3. Instalar

ssh root@server
sudo /tmp/bedrud install --tls --domain meet.example.com --email admin@example.com

Consulta la guía de instalación para todos los escenarios de instalación.

4. Crear usuario administrador

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

Despliegue con Docker

Compila y ejecuta con Docker:

docker build -t bedrud .
docker run -d --name bedrud -p 8090:8090 -p 7880:7880 -v bedrud-data:/var/lib/bedrud bedrud

También hay una imagen precompilada disponible:

docker pull ghcr.io/bedrud-ir/bedrud:latest

Consulta la guía de Docker para obtener detalles completos incluyendo volúmenes, configuración y Docker Compose.

Arquitectura de producción

flowchart TB
    NET[Internet] --> TRAEFIK["Traefik (443)<br/>TLS termination, reverse proxy"]
    TRAEFIK --> BEDRUD["Bedrud (8090)<br/>API + Web UI"]
    TRAEFIK --> LIVEKIT["LiveKit (7880)<br/>WebRTC media"]
    BEDRUD --> DB["SQLite<br/>(or PostgreSQL)"]

Para la conectividad WebRTC, también abre estos puertos en el firewall:

Consulta Conectividad WebRTC para la pila completa de conectividad.

Gestión de servicios

# Verificar estado
systemctl status bedrud livekit
 
# Reiniciar
systemctl restart bedrud
 
# Ver logs
journalctl -u bedrud -f
tail -f /var/log/bedrud/bedrud.log

Ubicación de archivos (producción)

CI/CD

Pipeline de lanzamientos

El workflow release.yml se dispara con tags de versión (v*) y produce:

Todos los artefactos se adjuntan al lanzamiento en GitHub.

Builds nocturnos

El workflow dev-nightly.yml produce builds de desarrollo de forma programada.

Verificaciones de CI

Cada push a main y cada pull request ejecuta: