Installer ATOUM sur un serveur

Le jeu tourne entièrement dans le navigateur. Le serveur ne sert qu'à trois choses : héberger les fichiers, faire tourner les parties en ligne, et garder les réglages partagés entre vos appareils.

Ce qu'il faut

Un hébergement mutualisé OVH avec PHP 8. C'est tout : ATOUM n'emploie ni base de données, ni bibliothèque, ni service extérieur. Les parties en ligne tiennent dans des fichiers JSON que le serveur écrit lui-même.

Poser les fichiers

Décompressez l'archive et déposez son contenu dans www/ par FTP — FileZilla, Cyberduck, ou l'explorateur de fichiers du manager OVH. Le dossier www/ est la racine publique d'un mutualisé : ce qui s'y trouve est servi à l'adresse du domaine.

Rien à compiler, rien à installer. Le jeu fonctionne dès que les fichiers sont en place.

Le seul dossier qui doit être inscriptible

api/parties/ reçoit les parties en ligne et le carnet des notifications. Sur OVH il l'est par défaut ; si les parties en ligne échouent, réglez-le en 755 depuis le manager.

Les autres dossiers restent en lecture seule, et c'est bien ainsi : rien d'autre n'a besoin d'écrire.

Installer, depuis cette page

Les notifications

Elles demandent une paire de clés VAPID, qu'on crée une fois. La page Installer ci-dessous le fait depuis le navigateur — inutile de toucher au serveur.

Les clés se rangent dans api/cles-vapid.json. Ce fichier ne doit jamais être partagé : il vaut mot de passe.

Mettre à jour

Déposez la nouvelle archive par-dessus l'ancienne, en écrasant. Ne touchez pas à api/parties/ ni à api/cles-vapid.json : les parties en cours et les notifications survivent ainsi à la mise à jour.

Les joueurs verront la nouvelle version au prochain chargement — le jeu recharge de lui-même quand il détecte un changement, sauf en pleine partie.

Si quelque chose ne va pas

• Le jeu se lance mais reste sur l'écran d'attente — un fichier de donnees/ manque ou n'est pas lisible. La console du navigateur nomme lequel.
• Le plateau s'affiche en clair, sans texture — les images de img/tuiles/ n'ont pas été téléversées. Le jeu fonctionne, il est seulement plus sobre.
• « clef refusée » en enregistrant les réglages — la clef du serveur et celle saisie diffèrent. Elle se ressaisit au prochain essai.
• Le jeu en ligne ne trouve pas la partie — vérifiez que api/parties/ est accessible en écriture par PHP.