Bedrud Documentation

Déployez Bedrud et rejoignez une réunion vidéo en moins de 5 minutes.

Dans ce guide :

  1. Installer la CLI — installation en une commande (ou téléchargement manuel)
  2. Déployer le serveurbedrud install configure tout
  3. Vérifier — confirmer que les services fonctionnent
  4. Créer un admin et rejoindre — ouvrir le navigateur, vous promouvoir, démarrer une réunion

Plus d’infos :

Binaire unique, pas besoin d’Internet après le téléchargement. Il inclut un serveur média intégré et SQLite - il fonctionne sur les réseaux isolés. Transférez le fichier, exécutez une commande, terminé.


Ce dont vous avez besoin

ExigenceDétails
Un serveur Linuxamd64 ou arm64, avec accès sudo et systemd. macOS/Windows : utilisez Docker ou WSL2 pour le serveur
Ports ouverts8090, 7880, 50000–60000/udp. Pour TLS automatique : également 80 et 443
Un domaine (optionnel)Avec un enregistrement DNS A pointant vers votre serveur. Pas de domaine ? Fonctionne avec IP - voir les alternatives ci-dessous

Comment ça fonctionne : Vous exécutez un serveur Bedrud unique. Les gens rejoignent les réunions dans leur navigateur (pas d’installation) ou via des applications natives (Android, Windows, macOS, Linux).


1. Installer la CLI Bedrud

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

Rechargez votre shell après l’installation :

source ~/.bashrc  # ou ~/.zshrc

Vérifiez :

bedrud --version

Pour les flags (--version, --install-dir, --skip-shell, installations hors ligne), voir CLI Installer.

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

Fermez et rouvrez votre terminal, puis vérifiez :

bedrud --version

Téléchargez et extrayez manuellement. Remplacez linux_amd64 par votre plateforme (linux_arm64, darwin_amd64, darwin_arm64) :

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 mv bedrud /usr/local/bin/

Pour toutes les plateformes cibles, voir CLI Installer.

Pas d’Internet sur le serveur ? Téléchargez sur n’importe quelle machine, transférez via USB ou scp bedrud.tar.xz user@server:/tmp/, puis extrayez là-bas. Le binaire est entièrement autonome - zéro requête sortante après le transfert.

Échec du téléchargement ? Vérifiez l’accès Internet, ou vérifiez l’URL sur github.com/bedrud-ir/bedrud/releases.


2. Déployer le serveur

La configuration du serveur nécessite Linux avec systemd. macOS et Windows ne prennent pas en charge bedrud install directement — utilisez Docker ou WSL2 à la place.

Remplacez meet.example.com et admin@example.com par vos valeurs :

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

Installe le binaire serveur dans /usr/local/bin, génère la configuration, crée les services systemd, provisionne TLS, démarre tout.

Port 80 ou 443 occupé ? Arrêtez les services en conflit : sudo systemctl stop nginx apache2 caddy, puis relancez.

Pas de domaine ? Utilisez l’IP de votre serveur à la place :

sudo bedrud install --tls --ip 1.2.3.4

Cela utilise un certificat auto-signé. Les navigateurs avertiront mais la vidéo fonctionne. Pour des certificats de confiance sur les réseaux internes, voir Guide TLS interne.


3. Vérification

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

Attendu : 200

Pas 200 ? Vérifiez l’état des services : sudo systemctl status bedrud livekit. Vérifiez les logs : journalctl -u bedrud -u livekit --no-pager -n 50.


4. Enregistrement et création d’admin

Ouvrez https://meet.example.com (ou https://<votre-ip>:8090) dans votre navigateur :

Promote User to Admin

Register via the web UI at your server URL, then promote the user to admin:

Alternatively, create a new admin user directly:

				
sudo ./bedrud user create --email admin@example.com --password secret --name "Admin"
sudo ./bedrud user promote --email admin@example.com
			
  1. Connectez-vous (ou rafraîchissez) — la section Admin apparaît dans la barre latérale (Vue d’ensemble, Utilisateurs, Salles, Paramètres). Succès : vous êtes admin.
  2. Créez une salleRejoignezPartagez vidéo/audio - accordez les autorisations caméra/mic lorsqu’on vous le demande

Tableau de bord admin - Après la promotion, connectez-vous pour accéder au panneau admin sur /dashboard/admin. Gérez les utilisateurs, les salles, les paramètres système et les jetons d’invitation.

Référence CLI - Gestion complète des utilisateurs : bedrud user promote, demote, create, delete.

Clients natifs pour Android, Windows, macOS et Linux : GitHub Releases. Ou partagez le lien de réunion - les participants rejoignent dans n’importe quel navigateur.


Chemins d’installation alternatifs

Docker

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

Configuration personnalisée, Docker Compose et variables d’environnement : voir Guide Docker.

Compilation depuis les sources

Nécessite Go 1.24+ et Bun :

git clone https://github.com/bedrud-ir/bedrud.git
cd bedrud
make init
make local-run

make init installe LiveKit, crée la configuration, récupère les dépendances. make local-run construit et démarre sur http://localhost:8090.

HTTP simple (développement / localhost uniquement)

sudo bedrud install --ip 127.0.0.1

Attention : Les navigateurs bloquent la caméra/mic sur non-HTTPS sauf localhost. HTTP est uniquement pour le développement.

Systèmes non-Linux

La commande bedrud install configure les services systemd et est réservée à Linux. L’installateur CLI (étape 1) fonctionne partout et place le binaire dans le PATH. Pour la configuration du serveur, utilisez Docker ou WSL2.

OSComment
macOSL’installateur CLI s’installe automatiquement dans ~/bin/
WindowsL’installateur CLI s’installe automatiquement dans %USERPROFILE%\bin\
DockerFonctionne sur tout OS avec Docker (voir ci-dessus)

Réseaux internes

Pas de domaine public ou d’Internet sortant ? Voir Guide TLS interne pour la configuration d’AC privée et la configuration du magasin de confiance client.


Configuration

L’installateur génère /etc/bedrud/config.yaml. Les valeurs par défaut fonctionnent pour la plupart des configurations. Changez jwtSecret et sessionSecret pour la production, puis redémarrez :

sudo systemctl restart bedrud livekit

Pour ajuster la capacité des salles, les délais d’expiration ou les ports média, voir Section LiveKit dans Configuration.

Référence complète : Configuration


Dépannage

ProblèmeCorrection
Port 80/443 utilisésudo systemctl stop nginx apache2 caddy
Les services ne démarrent pasjournalctl -u bedrud -u livekit --no-pager -n 50
Erreurs de certificat TLSVérifiez le DNS : dig meet.example.com. Doit pointer vers l’IP du serveur
Pas de vidéo / WebRTC échouéHTTPS requis pour la caméra. Utilisez --tls. Ouvrez UDP 50000–60000 sur le pare-feu
Conflits de ports LiveKitUtilisez les drapeaux --lk-port, --lk-tcp-port, --lk-udp-port
Pare-feu bloquant les médiassudo ufw allow 8090/tcp && sudo ufw allow 7880/tcp && sudo ufw allow 50000:60000/udp
Avertissements de certificat auto-signéVoir Guide TLS interne pour la configuration d’AC privée

Démontage

# Installation binaire
sudo bedrud uninstall
 
# Docker
docker stop bedrud && docker rm bedrud && docker volume rm bedrud-data
 
# Compilation depuis les sources
# Ctrl+C pour arrêter, puis : make clean

Prochaines étapes