Installation depuis les paquets .deb

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

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-4207-01.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-02.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-03.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-04.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-05.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-06.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-07.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-08.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-09.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-10.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-11.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-00.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-01.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-02.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-03.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-04.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-05.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-06.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-07.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-08.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-09.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-10.fits
#sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-11.fits

Pour télécharger tous les index d’un coup (plusieurs Go) :

for idx in 4208 4209 4210 4211 4212 4213 4214; do
    sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-${idx}.fits
done
for idx in 4206 4207; do
    for i in $(seq -w 0 11); do
        sudo wget -P /usr/share/astrometry http://data.astrometry.net/4200/index-${idx}-${i}.fits
    done
done

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

Télécharger la dernière release depuis le GitLab OST selon votre version d’Ubuntu :

Ubuntu 22.04 / 24.04 :

wget https://gitlab.ostserver.fr/api/v4/projects/1/packages/generic/latest/latest/ostserver_latest_amd64.deb

Ubuntu 26.04 :

wget https://gitlab.ostserver.fr/api/v4/projects/1/packages/generic/latest/latest/ostserver_latest_2604_amd64.deb

Installer le paquet :

sudo apt install -y ./ostserver_latest_amd64.deb        # 22.04 / 24.04
# ou
sudo apt install -y ./ostserver_latest_2604_amd64.deb   # 26.04

apt résout automatiquement toutes les dépendances.

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

Config Nginx déposée par le paquet :

server {
    listen 80;
    root /var/www/osterix;
    index index.html;
    server_name _;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /ostmedia/ {
        alias /var/lib/osterix/media/;
        autoindex on;
    }
}

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

Ubuntu 22.04 / 24.04 :

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

Ubuntu 26.04 :

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

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