Aller au contenu
Octoboard Documentation

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.

  • 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.

Terminal window
ssh <you>@<server>

Les étapes 1 et 2 ci-dessous s’exécutent sur le serveur, dans cette fenêtre connectée.

  1. Installez octoboardd sur le serveur.

    Terminal window
    curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh

    Il affiche une ligne qui commence par Installed octoboardd.

  2. Démarrez-le sur le serveur.

    Terminal window
    octoboardd start

    Il affiche une ligne qui commence par Octoboard started.

  3. 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 address

      Il affiche deux choses : une adresse de navigateur, qui commence par http://127.0.0.1:, et une commande ssh. Sur votre propre ordinateur, copiez la commande ssh, 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 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 :

Terminal window
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --service

Cette 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) :

Terminal window
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.

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 update

    S’il demande s’il faut redémarrer maintenant, répondez y pour redémarrer, ou appuyez sur Entrée pour garder l’ancienne version en marche pour le moment. Pour redémarrer plus tard, exécutez octoboardd 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.

Archive x86_64 Archive aarch64 Toutes les versions précédentes