Héberger un serveur

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…).

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.

Installation sous Windows

1. Installez Docker Desktop, lancez-le et attendez qu'il indique « Engine running ».
2. Téléchargez le kit serveur pour Windows et décompressez-le, par exemple dans C:\Voxsen-Server.
3. 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.
4. Le script construit et démarre le serveur (quelques minutes la première fois), puis affiche l'adresse à saisir dans l'app.

Installation sous Linux

tar -xzf Voxsen-Server-x.y.z.tar.gz
cd voxsen-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.

* 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).

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

1. Créez un enregistrement DNS de type A (par exemple voxsen.mondomaine.fr) vers l'IP publique du serveur. Chez Cloudflare, laissez d'abord le nuage gris (« DNS only »), voir plus bas.
2. Pendant l'installation, choisissez l'option 3 et saisissez le domaine.
3. 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.

Utiliser Cloudflare (facultatif)

C'est vous qui choisissez, selon le nuage de l'enregistrement DNS chez Cloudflare.

Nuage gris (« DNS only ») : le plus simple, conseillé. Cloudflare ne gère que le nom de domaine, rien d'autre à régler.

Nuage orange (proxy) : pour protéger le serveur (attaques, robots, IP du site cachée). Voxsen fonctionne derrière, avec ces réglages :

1. Installez d'abord en gris et attendez que le serveur réponde en https://, puis passez le nuage en orange.
2. SSL/TLS → « Full (strict) » (avec « Flexible », le site tourne en boucle de redirections).
3. Edge Certificates → « Always Use HTTPS » désactivé : le serveur redirige déjà lui-même, et le renouvellement du certificat en a besoin.
4. Gros fichiers : le plan gratuit refuse les envois de plus de 100 Mo. Ajoutez LIBRARY_MAX_MB=95 dans .env, puis docker compose --profile https up -d : l'app prévient avant d'envoyer un fichier trop gros.
5. Cache : règle « URI Path commence par /updates/ » → Bypass cache, pour que les mises à jour des apps soient toujours les bonnes.
6. Bot Fight Mode désactivé (Security → Bots), sinon l'app et les mises à jour automatiques peuvent être refusées.

La voix et la vidéo restent en direct (ports UDP 50000-50100 et TCP 7881, à garder ouverts) : les membres en vocal voient l'IP du serveur, comme avec n'importe quelle appli de voix. Le serveur lit tout seul la vraie IP de chaque visiteur derrière Cloudflare.

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

Mises à jour automatiques : toutes les 15 minutes, le serveur vérifie s'il existe une nouvelle version, l'installe et redémarre tout seul. Le journal est dans update.log. Pour les couper : VOXSEN_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 VOXSEN_PORT dans .env, puis lancez docker compose up -d.