Installazione tramite script

Ideale per i principianti

Non hai mai usato una riga di comando Linux? Questa pagina è per te. Segui semplicemente i tre passaggi sotto, in ordine.

Questo unico script, ostserver-setup.sh, installa tutto il necessario su una sola macchina: il back-end OST, l’interfaccia web, nginx, INDI, astrometry.net e la documentazione che stai leggendo in questo momento. Copre ogni sistema supportato, e lo stesso script gestisce anche gli aggiornamenti successivi — vedi Aggiornamenti successivi più sotto.


1. Installa un sistema pulito

Installa uno dei sistemi sotto sulla macchina che farà funzionare OST — un Raspberry Pi, un mini-PC, o una macchina virtuale. Usa l’installer standard di quel sistema; non è necessaria alcuna opzione speciale.

SistemaDa dove proviene il pacchetto OST
Ubuntu 24.04 LTS “Noble” (amd64)GitLab
Ubuntu 26.04 LTS “Resolute” (amd64)GitLab, oppure la Launchpad PPA — a tua scelta, lo script te lo chiede
Ubuntu 26.04 LTS “Resolute” (arm64 — Raspberry Pi)Solo Launchpad PPA
Fedora Server o Workstation (amd64)GitLab
Arch Linux (amd64)GitLab
Qualcos’altro?

Stai usando un sistema diverso (un’altra distribuzione, una versione di Ubuntu non supportata, Raspberry Pi OS…)? Lo script lo verifica per te e si interrompe con un messaggio chiaro invece di fare la cosa sbagliata - vedi invece Installazione manuale.

Una volta installato, apri un terminale — direttamente sulla macchina, oppure via SSH da un altro computer — con un account che possa usare sudo.


2. Scarica lo script

Copia il comando sotto, incollalo nel terminale, e premi Invio:

wget https://gitlab.ostserver.fr/ost/ostserver/-/raw/main/ostserver-setup.sh

Se funziona, sullo schermo non succede nulla — è normale. Un nuovo file, ostserver-setup.sh, è ora presente nella tua cartella corrente.


3. Esegui lo script

chmod +x ostserver-setup.sh
./ostserver-setup.sh

Lo script farà poi tutto da solo. Ecco alcune cose da aspettarsi:

  • Ti dice quale sistema ha rilevato, e ti avvisa prima se nota qualcosa già presente sulla macchina che vale la pena conoscere (un’installazione OST esistente, nginx già presente per qualcos’altro…). A questo punto non viene ancora toccato nulla.
  • Chiede tutto ciò che deve sapere da subito, tutto in una volta - non durante il percorso, come facevano i vecchi script di installazione. Quale fonte del pacchetto (quando c’è una scelta), quale versione, cosa installare (una configurazione completa, una minimale solo back-end, oppure scegliere i componenti uno per uno), e se aggiungere file indice astrometry.net extra per configurazioni a lunga focale. Una schermata blu gestisce ogni domanda: freccette per spostarti, Spazio per selezionare/deselezionare, Tab poi Invio per confermare. Se non sei sicuro riguardo ai file indice, lascia tutto deselezionato — potrai sempre aggiungerli in seguito (vedi Aggiornamenti successivi).
  • Chiederà la tua password una volta, verso l’inizio (sudo, per installare i pacchetti di sistema) - e resta autenticato per il resto dell’esecuzione dopo di ciò, anche se un passaggio richiede un po’ di tempo.
  • Su Arch Linux, installare astrometry.net e i driver INDI di terze parti compilano entrambi codice reale direttamente dal codice sorgente - è normale vedere pagine di output del compilatore scorrere sullo schermo, e che ciascuno richieda alcuni minuti.
  • Su Fedora, i driver INDI di terze parti provengono da un repository COPR mantenuto dalla comunità (non uno ufficiale Fedora/RPM Fusion) - lo script te lo segnala prima di usarlo. Apre anche le porte del firewall di cui hanno bisogno l’interfaccia web e il WebSocket (firewalld le blocca entrambe di default su Fedora, a differenza di Ubuntu/Arch).
  • Mostra messaggi di avanzamento mentre scarica e installa. Questo può richiedere alcuni minuti, a seconda della tua connessione Internet.

Alla fine, mostra due indirizzi, ad esempio:

Web UI: http://192.168.1.42/
Documentation: http://192.168.1.42/documentation/
La tua lingua

Lo script parla inglese, francese, tedesco, spagnolo e italiano, in base alla lingua già impostata sul tuo sistema. Niente da configurare.


Fatto

Apri il primo indirizzo (Web UI: ...) in un browser web, da qualsiasi dispositivo sulla stessa rete locale della macchina su cui hai appena installato OST. Dovresti vedere l’interfaccia OST.


Aggiornamenti successivi

Esegui esattamente lo stesso script di nuovo, sulla stessa macchina, ogni volta che vuoi aggiornare. Riconosce di aver già configurato questa macchina, mostra un rapido riepilogo di cosa è installato, e aggiorna il pacchetto invece di chiedere di nuovo ogni domanda — l’unica cosa che chiede di nuovo è se vuoi aggiungere altri file indice astrometry.net.

./ostserver-setup.sh

Se non hai più il file, scaricalo di nuovo nello stesso modo del passaggio 2 — eseguire una copia più vecchia funziona comunque, ma ottieni le ultime correzioni scaricandolo di nuovo prima.


Hai bisogno di più controllo?

Questo script fa delle scelte sensate per te (SSL disattivato, struttura di cartelle standard, nginx come web server). Se hai bisogno di qualcosa di diverso, vedi Installazione manuale invece — stesso risultato, ogni passaggio spiegato e personalizzabile.