Installer un serveur Voxsen sous Windows ou Linux

Avant de commencer

Un serveur Voxsen héberge tout ce qu'il faut à votre communauté : comptes, salons, messages, fichiers, voix et vidéo. Il tourne sur un PC Windows ou une machine Linux (VPS, mini-PC, Raspberry Pi 4/5 en 64 bits…).

Pas besoin de nom de domaine. L'adresse IP de la machine suffit, par exemple 82.64.10.20:3000. Un domaine reste possible pour une adresse plus jolie et le HTTPS automatique.

Ce qu'il faut

Windows 10/11 avec Docker Desktop, ou Linux avec Docker (le script l'installe pour vous).
2 Go de RAM et 2 cœurs pour une vingtaine de personnes.
Pour un accès par Internet : pouvoir ouvrir des ports sur la box ou le pare-feu.

Kit serveur Windows (.zip) Kit serveur Linux (.tar.gz)

Installation sous Windows

Installez Docker Desktop, lancez-le et attendez qu'il indique « Engine running ».
Téléchargez le kit serveur pour Windows et décompressez-le, par exemple dans C:\Voxsen-Server.
Double-cliquez sur Installer Voxsen Server.bat et répondez aux questions : le nom du serveur, comment les membres vont le joindre (IP publique, réseau local ou nom de domaine) et l'ouverture des ports dans le pare-feu Windows.
Le script construit et démarre le serveur (quelques minutes la première fois), puis affiche l'adresse à saisir dans l'app.

Docker Desktop doit rester lancé. Dans ses réglages, cochez « Start Docker Desktop when you sign in » : le serveur Voxsen redémarre alors tout seul avec Windows.

Installation sous Linux

tar -xzf Voxsen-Server-x.y.z.tar.gz
cd elio-server
./install.sh

Le script installe Docker s'il manque (avec votre accord), pose les mêmes questions que sous Windows, démarre le serveur et affiche l'adresse à saisir dans l'app.

Puissance et qualité vidéo

La voix ne demande presque rien. La vidéo, elle, dépend surtout du débit montant du serveur : il renvoie le flux de chaque personne qui partage à chaque spectateur. Le partage d'écran et la caméra vont jusqu'à la 4K à 60 i/s*, si le serveur et les participants suivent.

Qualité	Débit par spectateur (environ)	Exemple : 1 stream, 5 spectateurs
720p · 30 i/s	1,5 Mb/s	8 Mb/s montants
1080p · 60 i/s	6 Mb/s	30 Mb/s montants
1440p · 60 i/s	10 Mb/s	50 Mb/s montants
4K · 30 i/s	12 Mb/s	60 Mb/s montants
4K · 60 i/s	18 Mb/s	90 Mb/s montants

Une connexion fibre ou un VPS avec une bonne bande passante est conseillé pour la 4K. La personne qui partage doit aussi avoir un PC capable d'encoder la 4K et un débit montant suffisant ; sinon, la qualité baisse automatiquement.

* Soumis au propriétaire du serveur, selon son paramétrage : la caméra et le partage d'écran, quelle que soit la qualité (720p, 2K, 4K, 60 i/s), ne sont possibles que pour les rôles qui en ont la permission (Paramètres du serveur → Rôles → Caméra et partage d'écran : caméra, partage d'écran, son du PC, 2K, 4K et 60 i/s se règlent séparément).

Ouvrir les ports

Pour un accès par Internet, redirigez ces ports vers la machine du serveur (box : rubrique « NAT / PAT » ou « redirection de ports » ; VPS : pare-feu de l'hébergeur ou ufw).

Port	Protocole	Rôle
3000	TCP	L'app : comptes, messages, fichiers (80 et 443 avec un nom de domaine)
7881	TCP	Voix et vidéo (secours quand l'UDP est bloqué)
50000 à 50100	UDP	Voix et vidéo

Seulement en réseau local ? Rien à ouvrir : les membres saisissent l'adresse locale, par exemple 192.168.1.20:3000.

Avec un nom de domaine

Créez un enregistrement DNS de type A (par exemple voxsen.mondomaine.fr) vers l'IP publique du serveur. Chez Cloudflare, laissez le nuage gris (« DNS only »).
Pendant l'installation, choisissez l'option 3 et saisissez le domaine.
Ouvrez les ports 80 et 443 (TCP) en plus de 7881 et 50000-50100.

Le certificat HTTPS est obtenu et renouvelé automatiquement. Dans l'app, il suffit de saisir voxsen.mondomaine.fr. Un domaine gratuit (DuckDNS, par exemple) convient aussi, pratique si votre box n'a pas d'IP fixe.

Premier lancement

Ouvrez Voxsen, saisissez l'adresse du serveur en haut de l'écran de connexion (son nom s'affiche en vert quand elle est bonne), puis créez votre compte : le premier compte créé devient propriétaire du serveur. Créez donc le vôtre juste après l'installation.

Ensuite, dans le menu du serveur → Paramètres du serveur : nom, description, icône, couleur, message de bienvenue, fermeture des inscriptions, mot de passe d'entrée, salons, rôles et membres. Pour inviter vos amis : menu du serveur → Inviter des potes.

Au quotidien

Pour…	Commande (dans le dossier du serveur)
Voir ce qu'il se passe	`docker compose logs -f server`
Arrêter le serveur	`docker compose down`
Le redémarrer	`docker compose up -d`
Mettre à jour maintenant	`./update.sh` (Linux) ou `Mettre à jour Voxsen Server.bat` (Windows)

Mises à jour automatiques : chaque nuit à 4 h 30, le serveur vérifie s'il existe une nouvelle version, l'installe et redémarre tout seul (rattrapé au prochain allumage du PC sous Windows). Le journal est dans update.log. Pour les couper : ELIO_AUTO_UPDATE=false dans .env.

Sauvegarde : copiez le dossier data/ (base de données et fichiers) et le fichier .env, serveur arrêté de préférence. Votre configuration et vos données sont gardées lors d'une mise à jour.

En cas de souci

L'app affiche « Introuvable »

Vérifiez l'adresse (avec :3000 sans nom de domaine), que le serveur tourne (docker compose ps) et que le port 3000 est redirigé. Ouvrez http://ADRESSE:3000 dans un navigateur : la page « Ce serveur Voxsen fonctionne » doit s'afficher.

Connecté, mais pas de son en vocal

Ce sont presque toujours les ports UDP 50000-50100 (et TCP 7881) qui ne sont pas ouverts ou pas redirigés vers la bonne machine.

L'IP publique de la box change

Supprimez le fichier .env et relancez l'installation, ou passez à un nom de domaine (même gratuit) avec l'option 3.

Le port 3000 est déjà pris

Changez ELIO_PORT dans .env, puis lancez docker compose up -d.