Démarrer avec les applications sur ServerPrism

Ce guide vous accompagne dans la configuration et l'installation de l'application auto-hébergée de votre choix (5e Tools, Owncast, Rathole ou Yarr) sur votre serveur ServerPrism. Il couvre la commande, la configuration initiale, la configuration et les problèmes courants.

Avant de commencer

Assurez-vous d'avoir un compte ServerPrism et d'être prêt à déployer un nouveau serveur ou d'avoir un serveur 'Applications' existant prêt pour la configuration.

Commander sur ServerPrism

1. Sélectionnez un plan : Connectez-vous à ServerPrism et choisissez un serveur 'Applications'. Nous recommandons de commencer avec au moins 2 Go de RAM, en augmentant jusqu'à 12 Go pour les applications plus exigeantes ou les charges d'utilisateurs plus élevées.
2. Choisissez une région : Sélectionnez l'emplacement du serveur le plus proche de vos utilisateurs principaux pour des performances optimales.
3. Déployez : Finalisez la commande. Votre serveur commencera à être provisionné automatiquement.

Premier démarrage

Après la commande, votre serveur commencera à être provisionné. Ce processus prend généralement quelques minutes. Vous pouvez surveiller son statut via le panneau ServerPrism à l'adresse https://serverprism.com/dashboard. Une fois que le statut du serveur affiche 'Running' et que vous voyez une sortie de console indiquant que l'application a démarré, elle est prête.

Connexion / invitation d'utilisateurs

La méthode de connexion à votre application dépend de celle que vous avez déployée :

• 5e Tools : Accédez à votre instance via l'adresse IP et le port du serveur (par exemple, http://YOUR_SERVER_IP:PORT). Le port par défaut est généralement 80 ou 8080 pour les applications web. Vérifiez la variable APP_PORT dans l'onglet 'Startup' de votre panneau ServerPrism si elle est configurable.
• Owncast : Votre instance Owncast sera accessible via http://YOUR_SERVER_IP:PORT. Le port par défaut pour Owncast est 8080. Vous pouvez également configurer un domaine personnalisé ou un sous-domaine ServerPrism pour un accès plus facile.
• Rathole : Rathole est un proxy inverse. La connexion implique la configuration des clients pour qu'ils se connectent via Rathole à vos services internes. Cela nécessite la configuration du fichier server.toml de Rathole et des configurations client. Il n'a pas d'interface web directe pour les utilisateurs.
• Yarr : Accédez à votre instance Yarr via http://YOUR_SERVER_IP:PORT. Le port par défaut est généralement 8080.

Pour faciliter l'accès, vous pouvez associer un sous-domaine gratuit à votre serveur depuis votre tableau de bord ServerPrism.

Bases de la configuration

La configuration de chaque application se fait généralement via des variables d'environnement dans l'onglet Startup du panneau ServerPrism ou en modifiant des fichiers de configuration spécifiques à l'aide du File Manager ou de SFTP.

5e Tools

• Stockage des données : 5e Tools utilise une base de données locale. La configuration est minimale. Vous pouvez généralement trouver les paramètres liés aux chemins de données dans les variables de démarrage si nécessaire.
• Accès : Assurez-vous que la variable APP_PORT dans l'onglet Startup correspond au port auquel vous essayez d'accéder.

Owncast

• Fichier de configuration : Owncast utilise principalement config.yaml situé dans le répertoire de données de l'application. Vous pouvez le modifier via le File Manager.
• Accès administrateur : La première fois que vous accédez à Owncast, il vous sera demandé de créer un compte administrateur. C'est là que vous définissez votre clé de flux et d'autres paramètres.
• Variables de démarrage : Vérifiez l'onglet Startup pour OWNCAST_DATABASE_PATH, OWNCAST_DATA_PATH ou OWNCAST_PORT afin de personnaliser les emplacements des données ou les ports d'écoute.

Rathole

• Fichier de configuration : Rathole nécessite un fichier server.toml. Ce fichier définit les ports d'écoute et les services qu'il va proxifier. Vous devez modifier ce fichier pour rendre Rathole fonctionnel.
  • Exemple de server.toml (à modifier via le File Manager) :

  [server]
  bind_addr = "0.0.0.0:8000" # Server listening port
  
  [server.services.my_service]
  type = "tcp"
  token = "your_secret_token"
  bind_addr = "0.0.0.0:2222" # Port clients connect to
  remote_addr = "127.0.0.1:22" # Internal service Rathole forwards to
  

• Jetons : Assurez-vous que le token dans server.toml correspond à la configuration du client pour une connexion sécurisée.

Yarr

• Configuration : La configuration de Yarr est souvent gérée via des variables d'environnement ou un fichier config.json. Vérifiez l'onglet Startup pour des variables comme YARR_PORT, YARR_DATABASE_PATH ou YARR_ADMIN_EMAIL.
• Configuration initiale : La première fois que vous accédez à Yarr, vous devrez peut-être passer par un assistant de configuration initiale pour créer un utilisateur administrateur et configurer les paramètres de base.

Problèmes courants

1. L'application ne démarre pas : Vérifiez la console du serveur dans le panneau ServerPrism pour les messages d'erreur. Les fichiers de configuration manquants, les variables d'environnement incorrectes ou les conflits de ports sont des causes courantes. Assurez-vous que tous les fichiers requis sont présents et correctement formatés.
2. Impossible d'accéder à l'interface web :
   • Vérifiez que l'application est en cours d'exécution et écoute sur le port attendu (par exemple, 8080).
   • Vérifiez les règles de pare-feu de votre serveur (ServerPrism gère généralement cela, mais assurez-vous que votre application n'essaie pas d'utiliser un port non standard bloqué).
   • Confirmez que vous utilisez la bonne adresse IP et le bon port dans votre navigateur. Si vous utilisez un domaine, assurez-vous que le DNS pointe correctement vers l'IP de votre serveur.
3. Le client Rathole ne se connecte pas : Vérifiez à nouveau que le token dans votre server.toml correspond à la configuration du client. Assurez-vous que le bind_addr pour le service dans server.toml est correctement configuré et accessible.
4. Performances lentes : Si votre application fonctionne lentement, envisagez de mettre à niveau votre plan de serveur pour plus de RAM ou de CPU. Vous pouvez le faire depuis votre tableau de bord client ServerPrism.

Si vous rencontrez des problèmes persistants, rassemblez votre ID de serveur et la sortie de journal pertinente de la console et ouvrez un ticket de support à l'adresse https://serverprism.com/tickets.

Prochaines étapes

• Domaines personnalisés : Pour une configuration plus professionnelle, associez un domaine personnalisé ou un sous-domaine ServerPrism gratuit à votre application depuis votre tableau de bord ServerPrism.
• Changement de runtime : Si vous décidez de passer à une autre application (par exemple, d'Owncast à Yarr), vous pouvez le faire facilement via l'onglet Startup de votre panneau ServerPrism en sélectionnant un nouveau runtime. Cela réinitialisera votre serveur avec la nouvelle application.
• Configuration avancée : Référez-vous à la documentation officielle de l'application choisie pour les fonctionnalités avancées, les intégrations et les options de personnalisation.