Installation depuis le PPA Ubuntu (Launchpad)

Prérequis : Ubuntu Server 22.04 (Jammy), 24.04 (Noble) ou 26.04 (Resolute) vierge, accès sudo, connexion Internet.

Cette méthode utilise le PPA Launchpad officiel — ostserver est installé via apt et se met à jour automatiquement avec apt upgrade.

1. Mise à jour du système

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget gnupg2 ca-certificates lsb-release apt-transport-https

2. Installation d’INDI

INDI est la couche d’abstraction matérielle pilotant caméras, montures, focuseurs et roues à filtres. ostserver dépend de libindi1 — ce PPA fournit la version correcte.

sudo apt-add-repository ppa:mutlaqja/ppa -y
sudo apt update
sudo apt install -y libindi1 gsc

Ubuntu 26.04 : gsc non disponible dans le PPA

Le paquet gsc (Global Star Catalog) n’est pas encore publié pour Ubuntu 26.04 dans le PPA mutlaqja/ppa. Installez libindi1 sans gsc, puis récupérez manuellement le paquet depuis la version 25.04 :

sudo apt install -y libindi1
wget "https://launchpad.net/~mutlaqja/+archive/ubuntu/ppa/+files/gsc-data_1.3+202411060910~ubuntu25.04.1_all.deb"
wget "https://launchpad.net/~mutlaqja/+archive/ubuntu/ppa/+files/gsc_1.3+202411060910~ubuntu25.04.1_amd64.deb"
sudo dpkg -i gsc-data_1.3+202411060910~ubuntu25.04.1_all.deb gsc_1.3+202411060910~ubuntu25.04.1_amd64.deb

gsc contient essentiellement des données de catalogue — les paquets 25.04 fonctionnent sans modification sur 26.04.

3. Installation des index Astrometry.net

Requis pour le plate solving (modules Navigator et Polar).

sudo apt install -y astrometry.net

Les fichiers d’index ne sont pas disponibles via apt — les télécharger manuellement depuis http://data.astrometry.net/.

Choisir les bons index

Téléchargez uniquement les index adaptés à votre setup. En règle générale : commencez par les index 4208–4210 (champs larges) puis ajoutez 4206–4207 si vous avez une longue focale. Les index sont volumineux — plusieurs centaines de Mo chacun.

Décommentez les lignes correspondant à votre setup :

# --- Champs larges > 5° (grand angle, petite focale) ---
sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4214.fits
sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4213.fits
sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4212.fits
sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4211.fits
sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4210.fits
sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4209.fits
sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4208.fits

# --- Champs moyens 1°–5° (longue focale) — 12 fichiers par index ---
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-00.fits
#...
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-11.fits

4. Dépendances système

Le paquet ostserver requiert plusieurs bibliothèques Qt6, GSL, cfitsio, libnova et StellarSolver. apt les résoudra automatiquement, mais s’assurer que le dépôt universe est activé :

sudo add-apt-repository universe -y
sudo apt update

libstellarsolver est embarqué directement dans le paquet ostserver — aucune version Qt6 n’est encore publiée indépendamment.

5. Installation du back-end : ostserver

Ajouter le PPA officiel OST et installer ostserver :

sudo add-apt-repository ppa:gehelem/ostserver -y
sudo apt update
sudo apt install -y ostserver

apt résout automatiquement toutes les dépendances. Le paquet est disponible pour Ubuntu 22.04, 24.04 et 26.04 — apt installe automatiquement la version correcte pour votre système.

Le paquet installe :

/usr/bin/ostserver — le binaire principal
/usr/lib/libost*.so — les modules (focus, guider, sequencer, navigator, planner, polar, inspector, indipanel, allsky)

Service systemd inclus

Le paquet installe et active automatiquement le service ostserver. Le service s’exécute sous l’utilisateur qui a lancé sudo apt install, et le répertoire /var/lib/osterix/media est initialisé.

Port WebSocket

ostserver écoute en WebSocket sur le port 9624.

6. Installation du front-end : osterix

Télécharger la dernière release depuis le GitLab OST :

wget https://gitlab.ostserver.fr/api/v4/projects/6/packages/generic/latest/latest/osterix-front_latest.deb

Installer le paquet (nginx sera installé automatiquement) :

sudo apt install -y ./osterix-front_latest.deb

Le paquet installe automatiquement :

Les fichiers statiques Angular dans /var/www/osterix/
La config Nginx dans /etc/nginx/sites-available/osterix
Le lien symbolique /etc/nginx/sites-enabled/osterix
Recharge Nginx

7. Vérification de l’installation

# État des services
sudo systemctl status ostserver
sudo systemctl status nginx

# Ports en écoute
ss -tlnp | grep -E '80|9624|7624'

# Logs ostserver en temps réel
sudo journalctl -u ostserver -f

# Tester la config Nginx
sudo nginx -t

8. Premier démarrage

Depuis un navigateur sur le réseau local : http://<ip-de-la-machine>/

Démarrer le serveur INDI avec vos pilotes
Ouvrir l’interface OST → http://<ip>/

Les modules sont accessibles depuis le menu principal.

Récapitulatif des services

Service	Rôle	Port
`ostserver`	Back-end C++/Qt, orchestration astrophoto	9624 (WebSocket)
`nginx`	Sert le front Angular	80
`indiserver`	Couche pilotes matériels INDI	7624

Mise à jour

sudo apt update && sudo apt upgrade -y
wget https://gitlab.ostserver.fr/api/v4/projects/6/packages/generic/latest/latest/osterix-front_latest.deb
sudo apt install -y ./osterix-front_latest.deb
sudo systemctl restart ostserver

ostserver se met à jour via apt upgrade comme n’importe quel paquet système. Nginx se recharge automatiquement via le postinst du paquet osterix.

Désinstallation

sudo apt remove ostserver osterix-front
sudo systemctl disable --now ostserver
sudo rm /etc/systemd/system/ostserver.service
sudo systemctl daemon-reload