Install via script

Best for beginners

Never used a Linux command line before? This is the page for you. Just follow the three steps below, in order.

This single script, ostserver-setup.sh, installs everything needed on one machine: the OST backend, the web interface, nginx, INDI, astrometry.net and the documentation you are reading right now. It covers every supported system, and the same script handles updates later too — see Updating later below.


1. Install a fresh system

Install one of the systems below on the machine that will run OST — a Raspberry Pi, a mini-PC, or a virtual machine. Use the standard installer for that system; no special option is needed.

SystemWhere the OST package comes from
Ubuntu 24.04 LTS “Noble” (amd64)GitLab
Ubuntu 26.04 LTS “Resolute” (amd64)GitLab, or the Launchpad PPA — your choice, the script asks
Ubuntu 26.04 LTS “Resolute” (arm64 — Raspberry Pi)Launchpad PPA only
Fedora Server or Workstation (amd64)GitLab
Arch Linux (amd64)GitLab
Something else?

Running a different system (another distribution, an unsupported Ubuntu version, Raspberry Pi OS…)? The script checks this for you and stops with a clear message instead of doing the wrong thing - see Manual installation instead.

Once it is installed, open a terminal — directly on the machine, or over SSH from another computer — with an account that can use sudo.


2. Download the script

Copy the command below, paste it into the terminal, and press Enter:

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

Nothing happens on screen if it works — that is normal. A new file, ostserver-setup.sh, now exists in your current folder.


3. Run the script

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

The script then does everything by itself. A few things to expect:

  • It tells you what system it detected, and warns you first if it notices anything already on the machine worth knowing about (an existing OST install, nginx already there for something else…). Nothing is touched yet at that point.
  • It asks everything it needs to know up front, all at once - not partway through, the way older install scripts used to. Which package source (when there is a choice), which version, what to install (a complete setup, a minimal backend-only one, or pick components one by one), and whether to add extra astrometry.net index files for long-focal-length setups. A blue screen handles each question: arrow keys to move, Space to check/uncheck, Tab then Enter to confirm. If you are not sure about the index files, leave everything unchecked — you can always add them later (see Updating later).
  • It will ask for your password once, near the start (sudo, to install system packages) - and stays authenticated for the rest of the run after that, even if a step takes a while.
  • On Arch Linux, installing astrometry.net and the third-party INDI drivers both compile real code straight from source - it is normal to see pages of compiler output scroll by, and for each to take several minutes.
  • On Fedora, the third-party INDI drivers come from a community-maintained COPR repository (not an official Fedora/RPM Fusion one) - the script tells you so before using it. It also opens the firewall ports the web interface and the WebSocket need (firewalld blocks both by default on Fedora, unlike Ubuntu/Arch).
  • It prints progress messages as it downloads and installs. This can take a few minutes depending on your Internet connection.

At the very end, it prints two addresses, for example:

Web UI: http://192.168.1.42/
Documentation: http://192.168.1.42/documentation/
Your own language

The script speaks English, French, German, Spanish and Italian, matching whatever language your system is already set to. Nothing to configure.


Done

Open the first address (Web UI: ...) in a web browser, from any device on the same local network as the machine you just installed OST on. You should see the OST interface.


Updating later

Run the exact same script again, on the same machine, whenever you want to update. It recognizes it already set this machine up, shows a quick recap of what is installed, and refreshes the package instead of asking every question again — the only thing it asks again is whether you want to add more astrometry.net index files.

./ostserver-setup.sh

If you no longer have the file, download it again the same way as in step 2 — running an older copy still works, but you get the latest fixes by fetching it fresh first.


Need more control?

This script makes sensible choices for you (SSL disabled, standard folder layout, nginx as the web server). If you need something different, see Manual installation instead — same result, every step explained and adjustable.