Installazione dal PPA Ubuntu (Launchpad)

Prerequisiti: Ubuntu Server 26.04 (Resolute) vergine, accesso sudo, connessione Internet.

Questo metodo usa il PPA Launchpad ufficiale — ostserver-complete viene installato tramite apt e si aggiorna automaticamente con apt upgrade.

1. Aggiornamento del sistema

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

2. Installazione di INDI

INDI è il livello di abstrazione hardware che pilota camere, montature, focheggiatori e ruote portafiltri. ostserver dipende da libindi1, e la maggior parte delle camere (ZWO, QHY, PlayerOne e altre) necessita del proprio driver da indi-3rdparty-drivers.

sudo add-apt-repository -y ppa:mutlaqja/ppa
sudo add-apt-repository -y universe
sudo apt update
sudo apt install -y libindi1 indi-bin gsc indi-3rdparty-libs indi-3rdparty-drivers

3. Installazione degli indici Astrometry.net

Richiesti per il plate solving (moduli Navigator e Polar).

sudo apt install -y astrometry.net

I file indice non sono disponibili tramite apt — scaricarli manualmente da http://data.astrometry.net/.

Decommentare le righe corrispondenti al proprio setup:

# --- Wide field > 5° (wide-angle, short focal length) ---
sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4214.fits
sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4213.fits
sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4212.fits
sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4211.fits
sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4210.fits
sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4209.fits
sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4208.fits

# --- Medium field 1°–5° (long focal length) — 12 files per index ---
#sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4207-00.fits
#...
#sudo wget -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-4206-11.fits

Per scaricare tutti gli indici in una volta (diversi GB):

for idx in 4208 4209 4210 4211 4212 4213 4214; do
    sudo wget -nc -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 -nc -P /usr/share/astrometry http://data.astrometry.net/4200/index-${idx}-${i}.fits
    done
done

-nc (no-clobber) salta un file già scaricato — si può rilanciare questa sezione in sicurezza per completare un set parziale.

4. Dipendenze di sistema

Il pacchetto ostserver-complete richiede diverse librerie Qt6, GSL, cfitsio, libnova e StellarSolver, oltre a nginx. apt le risolverà automaticamente, ma assicurarsi che il repository universe sia attivato:

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

libstellarsolver è incorporato direttamente nel pacchetto — nessuna versione Qt6 è ancora pubblicata indipendentemente.

5. Installazione di ostserver-complete

Aggiungere il PPA ufficiale OST e installare ostserver-complete — back-end, tutti i moduli, l’interfaccia web e il collegamento nginx tra di essi, tutto in un unico pacchetto:

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

apt risolve automaticamente tutte le dipendenze, nginx incluso.

Il pacchetto installa:

• /usr/bin/ostserver — il binario principale
• /usr/lib/libost*.so — i moduli (focus, guider, sequencer, navigator, planner, polar, inspector, indipanel, allsky)
• i file statici dell’interfaccia web, con un sito nginx già configurato per servirli

6. Verifica dell’installazione

# Service status
sudo systemctl status ostserver
sudo systemctl status nginx

# Listening ports
ss -tlnp | grep -E '80|9624|7624'

# Live ostserver logs
sudo journalctl -u ostserver -f

# Test Nginx config
sudo nginx -t

7. Primo avvio

Da un browser sulla rete locale: http://<machine-ip>/

1. Avviare il server INDI con i propri driver
2. Aprire l’interfaccia OST → http://<ip>/

I moduli sono accessibili dal menu principale.

Riepilogo dei servizi

Aggiornamento

sudo apt update && sudo apt upgrade -y

ostserver-complete si aggiorna tramite apt upgrade come qualsiasi pacchetto di sistema — nginx e i file statici dell’interfaccia web vengono aggiornati insieme.

Disinstallazione

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