Installation par script
Vous n’avez jamais utilisé de ligne de commande Linux ? Cette page est faite pour vous. Suivez simplement les trois étapes ci-dessous, dans l’ordre.
Un script unique, ostserver-setup.sh, installe tout ce qui est
nécessaire sur une seule machine : le back-end OST, l’interface web,
nginx, INDI, astrometry.net et la documentation que vous êtes en
train de lire. Il couvre tous les systèmes supportés, et le même
script gère aussi les mises à jour ultérieures — voir
Mise à jour ultérieure ci-dessous.
1. Installer un système vierge
Installez l’un des systèmes ci-dessous sur la machine qui va faire tourner OST — un Raspberry Pi, un mini-PC, ou une machine virtuelle. Utilisez l’installeur standard de ce système ; aucune option particulière n’est nécessaire.
| Système | D’où vient le paquet OST |
|---|---|
| Ubuntu 24.04 LTS « Noble » (amd64) | GitLab |
| Ubuntu 26.04 LTS « Resolute » (amd64) | GitLab, ou le PPA Launchpad — à votre choix, le script vous le demande |
| Ubuntu 26.04 LTS « Resolute » (arm64 — Raspberry Pi) | PPA Launchpad uniquement |
| Fedora Server ou Workstation (amd64) | GitLab |
| Arch Linux (amd64) | GitLab |
Vous utilisez un système différent (une autre distribution, une version d’Ubuntu non prise en charge, Raspberry Pi OS…) ? Le script vérifie cela pour vous et s’arrête avec un message clair plutôt que de faire n’importe quoi - voir plutôt l’Installation manuelle.
Une fois celui-ci installé, ouvrez un terminal — directement sur la
machine, ou en SSH depuis un autre ordinateur — avec un compte pouvant
utiliser sudo.
2. Télécharger le script
Copiez la commande ci-dessous, collez-la dans le terminal, et appuyez sur Entrée :
wget https://gitlab.ostserver.fr/ost/ostserver/-/raw/main/ostserver-setup.shRien ne s’affiche à l’écran si tout fonctionne — c’est normal. Un
nouveau fichier, ostserver-setup.sh, existe maintenant dans votre
dossier courant.
3. Exécuter le script
chmod +x ostserver-setup.sh
./ostserver-setup.shLe script fait alors tout lui-même. Voici à quoi vous attendre :
- Il vous indique quel système il a détecté, et vous prévient d’abord s’il remarque quelque chose déjà présent sur la machine qui vaut la peine d’être signalé (une installation OST existante, nginx déjà présent pour autre chose…). Rien n’est encore modifié à ce stade.
- Il demande tout ce dont il a besoin d’emblée, en une seule fois
- pas au fil de l’eau, comme le faisaient les anciens scripts
d’installation. Quelle source de paquet (quand il y a un choix),
quelle version, quoi installer (une installation complète, une
installation minimale back-end uniquement, ou le choix des
composants un par un), et s’il faut ajouter des fichiers d’index
astrometry.netsupplémentaires pour les configurations à longue focale. Un écran bleu gère chaque question : flèches pour se déplacer, Espace pour cocher/décocher, Tab puis Entrée pour confirmer. Si vous n’êtes pas sûr pour les fichiers d’index, laissez tout décoché — vous pourrez toujours les ajouter plus tard (voir Mise à jour ultérieure).
- pas au fil de l’eau, comme le faisaient les anciens scripts
d’installation. Quelle source de paquet (quand il y a un choix),
quelle version, quoi installer (une installation complète, une
installation minimale back-end uniquement, ou le choix des
composants un par un), et s’il faut ajouter des fichiers d’index
- Il demande votre mot de passe une fois, au début (
sudo, pour installer des paquets système) - et reste authentifié pour le reste de l’exécution après ça, même si une étape prend du temps. - Sur Arch Linux, installer
astrometry.netet les pilotes INDI tiers compile tous les deux du vrai code directement depuis les sources - il est normal de voir défiler des pages de sortie du compilateur, et que chacun prenne plusieurs minutes. - Sur Fedora, les pilotes INDI tiers viennent d’un dépôt COPR
maintenu par la communauté (pas un dépôt officiel Fedora/RPM
Fusion) - le script vous le signale avant de l’utiliser. Il ouvre
aussi les ports du pare-feu dont l’interface web et le WebSocket ont
besoin (
firewalldbloque les deux par défaut sur Fedora, contrairement à Ubuntu/Arch). - Il affiche des messages de progression pendant le téléchargement et l’installation. Cela peut prendre quelques minutes selon votre connexion Internet.
À la toute fin, il affiche deux adresses, par exemple :
Web UI: http://192.168.1.42/
Documentation: http://192.168.1.42/documentation/Le script parle anglais, français, allemand, espagnol et italien, selon la langue déjà configurée sur votre système. Rien à configurer.
Terminé
Ouvrez la première adresse (Web UI: ...) dans un navigateur web,
depuis n’importe quel appareil sur le même réseau local que la machine
sur laquelle vous venez d’installer OST. Vous devriez voir l’interface
OST.
Mise à jour ultérieure
Exécutez exactement le même script, sur la même machine, chaque fois
que vous voulez mettre à jour. Il reconnaît qu’il a déjà configuré
cette machine, affiche un rapide récapitulatif de ce qui est installé,
et rafraîchit le paquet au lieu de reposer toutes les questions — la
seule chose qu’il redemande, c’est si vous voulez ajouter d’autres
fichiers d’index astrometry.net.
./ostserver-setup.shSi vous n’avez plus le fichier, téléchargez-le à nouveau de la même façon qu’à l’étape 2 — exécuter une ancienne copie fonctionne toujours, mais vous obtenez les derniers correctifs en le récupérant à nouveau au préalable.
Ce script fait des choix raisonnables à votre place (SSL désactivé, arborescence de dossiers standard, nginx comme serveur web). Si vous avez besoin d’autre chose, voir plutôt l’Installation manuelle — même résultat, mais chaque étape est expliquée et ajustable.