Instalación desde los paquetes .deb

Requisitos previos: Ubuntu Server 22.04 (Jammy), 24.04 (Noble) o 26.04 (Resolute) limpio, acceso sudo, conexión a Internet.

1. Actualización del sistema

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

2. Instalación de INDI

INDI es la capa de abstracción de hardware que controla cámaras, monturas, enfocadores y ruedas de filtros. ostserver depende de libindi1, y la mayoría de las cámaras (ZWO, QHY, PlayerOne y otras) necesitan su controlador de 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?

Desde agosto de 2026, ppa:mutlaqja/ppa solo publica para Ubuntu 26.04 — en 22.04 (Jammy) o 24.04 (Noble), utilice en su lugar el archivo fijo que se indica a continuación.

Ubuntu 22.04 / 24.04 (archivo fijo)

# 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 completa las dependencias de ejecución restantes (libgsl, liberfa, libpugixml…) desde el repositorio universe — asegúrese de que esté activado (ver §4). El paquete gsc (Global Star Catalog, utilizado por el simulador CCD de INDI para producir un campo de estrellas realista) está incluido en el archivo.

Todavía sin controladores de cámara de terceros aquí

Este archivo fijo solo cubre libindi1/libxisf/gsc — por el momento no incluye indi-3rdparty-drivers (ZWO/QHY/PlayerOne…) para 22.04/24.04.

3. Instalación de los índices de Astrometry.net

Necesarios para el plate solving (módulos Navigator y Polar).

sudo apt install -y astrometry.net

Los archivos de índice no están disponibles vía apt — descárguelos manualmente desde http://data.astrometry.net/.

Elegir los índices correctos

Descargue únicamente los índices adecuados a su configuración. Como regla general: los índices 4208–4210 cubren campos amplios. Añada 4206–4207 para distancias focales más largas. Cada índice ocupa varios cientos de MB.

Descomente las líneas correspondientes a su configuración:

# --- 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

Para descargar todos los índices de una vez (varios 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) omite un archivo ya descargado — puede volver a ejecutar esta sección sin riesgo para completar un conjunto parcial.

4. Dependencias del sistema

El paquete ostserver-complete requiere varias bibliotecas Qt6, GSL, cfitsio, libnova y StellarSolver, además de nginx. apt las resolverá automáticamente, pero asegúrese de que el repositorio universe esté activado:

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

libstellarsolver está incluido directamente en el paquete — aún no se publica ninguna versión Qt6 de forma independiente.

5. Instalación de ostserver-complete

Un único paquete proporciona el back-end, todos los módulos, la interfaz web y la configuración de nginx que los conecta. Descargue el que corresponda a su versión de Ubuntu desde el GitLab de OST:

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 resuelve automáticamente todas las dependencias, incluido nginx.

El paquete instala:

  • /usr/bin/ostserver — el binario principal
  • /usr/lib/libost*.so — los módulos (focus, guider, sequencer, navigator, planner, polar, inspector, indipanel, allsky)
  • los archivos estáticos de la interfaz web, con un sitio nginx ya configurado para servirlos
Servicio systemd incluido

El paquete instala y activa automáticamente el servicio ostserver. El servicio se ejecuta bajo el usuario que lanzó sudo apt install, y el directorio /var/lib/osterix/media se inicializa.

Puerto WebSocket

ostserver escucha en WebSocket en el puerto 9624.

6. Verificación de la instalación

# 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. Primer arranque

Desde un navegador en la red local: http://<machine-ip>/

  1. Inicie el servidor INDI con sus controladores
  2. Abra la interfaz OST → http://<ip>/

Los módulos son accesibles desde el menú principal.

Resumen de los servicios

ServicioFunciónPuerto
ostserverBack-end C++/Qt, orquestación astrofoto9624 (WebSocket)
nginxSirve la interfaz web80
indiserverCapa de controladores de hardware INDI7624

Actualización

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

Desinstalación

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