Installation aus den .deb-Paketen

Voraussetzungen: frisches Ubuntu Server 22.04 (Jammy), 24.04 (Noble) oder 26.04 (Resolute), sudo-Zugriff, Internetverbindung.


1. System aktualisieren

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

2. INDI installieren

INDI ist die Hardware-Abstraktionsschicht, die Kameras, Montierungen, Fokussierer und Filterräder steuert. ostserver benötigt libindi1, und die meisten Kameras (ZWO, QHY, PlayerOne und andere) brauchen ihren Treiber aus indi-3rdparty-drivers.

Ubuntu 26.04 (Resolute)

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
22.04 / 24.04?

Seit August 2026 veröffentlicht ppa:mutlaqja/ppa nur noch für Ubuntu 26.04 — unter 22.04 (Jammy) oder 24.04 (Noble) stattdessen das eingefrorene Archiv unten verwenden.

Ubuntu 22.04 / 24.04 (eingefrorenes Archiv)

# Pick the one for your release:
INDI_TAR=indi-deps-noble.tar      # Ubuntu 24.04 (Noble)
# INDI_TAR=indi-deps-jammy.tar    # Ubuntu 22.04 (Jammy)

wget "https://gitlab.ostserver.fr/api/v4/projects/1/packages/generic/indi-deps/2.2.4/${INDI_TAR}"
tar xf "${INDI_TAR}"
sudo apt install -y ./indi-deps/*.deb

apt löst die restlichen Laufzeitabhängigkeiten (libgsl, liberfa, libpugixml …) über das universe-Repository — stellen Sie sicher, dass es aktiviert ist (siehe §4). Das Paket gsc (Global Star Catalog, vom INDI-CCD-Simulator zur Erzeugung eines realistischen Sternfelds verwendet) ist im Archiv enthalten.

Noch keine Kameratreiber von Drittanbietern

Dieses eingefrorene Archiv deckt nur libindi1/libxisf/gsc ab — es enthält derzeit nicht indi-3rdparty-drivers (ZWO/QHY/PlayerOne …) für 22.04/24.04.


3. Astrometry.net-Indizes installieren

Erforderlich für Plate Solving (Module Navigator und Polar).

sudo apt install -y astrometry.net

Die Indexdateien sind nicht über apt verfügbar — manuell von http://data.astrometry.net/ herunterladen.

Die richtigen Indizes wählen

Laden Sie nur die zu Ihrem Setup passenden Indizes herunter. Als Faustregel: die Indizes 4208–4210 decken weite Felder ab. Für längere Brennweiten 4206–4207 ergänzen. Jeder Index ist mehrere Hundert MB groß.

Die zu Ihrem Setup passenden Zeilen auskommentieren:

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

Um alle Indizes auf einmal herunterzuladen (mehrere 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) überspringt eine bereits heruntergeladene Datei — dieser Abschnitt kann so bedenkenlos erneut ausgeführt werden, um einen unvollständigen Satz zu ergänzen.


4. Systemabhängigkeiten

Das Paket ostserver-complete benötigt mehrere Qt6-, GSL-, cfitsio-, libnova- und StellarSolver-Bibliotheken sowie nginx. apt löst diese automatisch, stellen Sie aber sicher, dass das universe-Repository aktiviert ist:

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

libstellarsolver ist direkt in das Paket eingebettet — es gibt noch keine eigenständig veröffentlichte Qt6-Version.


5. ostserver-complete installieren

Ein einzelnes Paket liefert das Backend, alle Module, die Web-UI und die nginx-Verknüpfung dazwischen. Das zu Ihrer Ubuntu-Version passende Paket vom OST-GitLab herunterladen:

DEB=ostserver-complete_latest_2604_amd64.deb   # Ubuntu 26.04 (Resolute)
# DEB=ostserver-complete_latest_2404_amd64.deb # Ubuntu 24.04 (Noble)
# DEB=ostserver-complete_latest_2204_amd64.deb # Ubuntu 22.04 (Jammy)

wget "https://gitlab.ostserver.fr/api/v4/projects/1/packages/generic/latest/latest/${DEB}"
sudo apt install -y "./${DEB}"

apt löst automatisch alle Abhängigkeiten, nginx eingeschlossen.

Das Paket installiert:

  • /usr/bin/ostserver — die Hauptbinärdatei
  • /usr/lib/libost*.so — die Module (focus, guider, sequencer, navigator, planner, polar, inspector, indipanel, allsky)
  • die statischen Dateien der Web-UI, mit einer bereits eingerichteten nginx-Site zu deren Auslieferung
Systemd-Dienst inklusive

Das Paket installiert und aktiviert automatisch den Dienst ostserver. Der Dienst läuft unter dem Benutzer, der sudo apt install ausgeführt hat, und das Verzeichnis /var/lib/osterix/media wird initialisiert.

WebSocket-Port

ostserver lauscht per WebSocket auf Port 9624.


6. Installation überprüfen

# 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. Erster Start

Über einen Browser im lokalen Netzwerk: http://<machine-ip>/

  1. Den INDI-Server mit Ihren Treibern starten
  2. Die OST-Oberfläche öffnen → http://<ip>/

Die Module sind über das Hauptmenü erreichbar.


Übersicht der Dienste

ServiceRollePort
ostserverBackend C++/Qt, Astrofoto-Orchestrierung9624 (WebSocket)
nginxLiefert die Web-UI aus80
indiserverINDI-Hardware-Treiberschicht7624

Aktualisierung

DEB=ostserver-complete_latest_2604_amd64.deb   # Ubuntu 26.04 (Resolute)
# DEB=ostserver-complete_latest_2404_amd64.deb # Ubuntu 24.04 (Noble)
# DEB=ostserver-complete_latest_2204_amd64.deb # Ubuntu 22.04 (Jammy)

wget "https://gitlab.ostserver.fr/api/v4/projects/1/packages/generic/latest/latest/${DEB}"
sudo apt install -y "./${DEB}"
sudo systemctl restart ostserver

Deinstallation

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