Serveur Linux
Installez octoboardd, le programme serveur de Octoboard (l’app l’appelle le service), sur un serveur Linux sans droits root. Accédez-y depuis l’app macOS ou Windows, ou depuis un navigateur, dans les deux cas par SSH.
Pour x86_64 et aarch64, sur n’importe quelle distribution.
Avant de commencer
Section intitulée « Avant de commencer »- Un serveur Linux sur lequel vous pouvez vous connecter en SSH. SSH est une façon sécurisée de se connecter à une autre machine et d’y taper des commandes. Le fournisseur du serveur vous donne son adresse et votre nom d’utilisateur.
- L’app Octoboard sur votre propre ordinateur, pour macOS ou Windows, si vous voulez travailler dans l’app de bureau (recommandé).
Pour vous connecter, ouvrez Terminal (macOS) ou PowerShell (Windows) sur votre propre ordinateur et exécutez la commande ci-dessous, en remplaçant <you> par votre nom d’utilisateur et <server> par l’adresse du serveur. La première fois, répondez yes quand on vous demande si vous faites confiance au serveur.
ssh <you>@<server>Les étapes 1 et 2 ci-dessous s’exécutent sur le serveur, dans cette fenêtre connectée.
Installation
Section intitulée « Installation »-
Installez octoboardd sur le serveur.
Terminal window curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | shIl affiche une ligne qui commence par
Installed octoboardd. -
Démarrez-le sur le serveur.
Terminal window octoboardd startIl affiche une ligne qui commence par
Octoboard started. -
Connectez-vous-y depuis votre propre ordinateur, de l’une des deux façons suivantes :
-
Depuis l’app de bureau (recommandé) : suivez Se connecter à un serveur Linux dans le guide SSH.
-
Depuis un navigateur : exécutez ceci sur le serveur.
Terminal window octoboardd addressIl affiche deux choses : une adresse de navigateur, qui commence par
http://127.0.0.1:, et une commandessh. Sur votre propre ordinateur, copiez la commandessh, remplacez<server>par l’adresse du serveur (l’adresse IP ou le nom que vous utilisez pour vous y connecter) et exécutez-la dans Terminal ou PowerShell. Elle peut vous demander votre mot de passe, puis n’affiche plus rien : c’est normal. Laissez cette fenêtre ouverte : la fermer coupe la connexion. Ouvrez ensuite l’adresse affichée dans votre navigateur.
-
Vous saurez que ça a marché quand Octoboard s’ouvre dans la nouvelle fenêtre de l’app de bureau, ou dans l’onglet du navigateur.
Si octoboardd est introuvable
Section intitulée « Si octoboardd est introuvable »Si l’installation indique qu’un dossier se terminant par .local/bin (par exemple /home/<you>/.local/bin) n’est pas dans votre PATH, le shell ne trouve pas octoboardd par son nom. Exécutez-le avec le chemin complet affiché par l’installation, ou ajoutez ~/.local/bin à votre PATH (par exemple dans ~/.profile) et reconnectez-vous.
Le garder actif après une déconnexion ou un redémarrage
Section intitulée « Le garder actif après une déconnexion ou un redémarrage »Démarré avec octoboardd start, octoboardd s’arrête quand le serveur redémarre, et rien ne le relance tout seul : exécutez de nouveau octoboardd start, ou connectez-vous depuis l’app de bureau, qui propose de le démarrer pour vous. Certains serveurs l’arrêtent aussi quand vous vous déconnectez.
Pour qu’il démarre avec le serveur et reste actif après votre déconnexion, installez-le plutôt comme un service :
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --serviceCette commande installe le programme, le configure comme un service utilisateur systemd et le démarre. Elle active ensuite la persistance de session (lingering), qui permet à vos services de tourner quand vous n’êtes pas connecté. Si elle indique qu’elle n’a pas pu le faire, exécutez ceci une fois (sudo peut être nécessaire) :
loginctl enable-linger "$USER"Le port par défaut est 3369. Pour en utiliser un autre, ajoutez --port <port> à la fin de la commande du service, ou à octoboardd start.
Mise à jour
Section intitulée « Mise à jour »Octoboard ne se met jamais à jour tout seul : quand une nouvelle version est disponible, le navigateur vous le signale, et vous choisissez quand l’installer. Une fois la nouvelle version installée, Octoboard redémarre dessus tout seul quand aucune session ne risque d’être interrompue ; si certaines le seraient, il les liste et vous demande d’abord.
-
Dans le navigateur : sélectionnez Télécharger et installer là où il est indiqué qu’une nouvelle version est disponible.
-
Sur le serveur : exécutez cette commande.
Terminal window octoboardd updateS’il demande s’il faut redémarrer maintenant, répondez
ypour redémarrer, ou appuyez sur Entrée pour garder l’ancienne version en marche pour le moment. Pour redémarrer plus tard, exécutezoctoboardd restart.
Si octoboardd update indique qu’il ne peut pas remplacer le programme, par exemple parce qu’il a été installé à un endroit où vous ne pouvez pas écrire, exécutez plutôt de nouveau la commande d’installation (ou celle du service). Il redémarre de la même façon quand c’est sûr, et sinon vous dit d’exécuter octoboardd restart.