indi-allsky has a significant set of library requirements. Not every package that is installed is needed in all cases, however, they are installed as a precaution. In some cases where pre-compiled Python wheels are not available for a platform, the Python pip tool may attempt to compile python modules from source.

Before proceeding with the installation, ensure your system timezone and locales are properly configured. Accurate system timezone and time synchronization are essential for astronomical calculations (sun/moon positions, day/night transitions, and exposure scheduling).

Verify and set your local timezone using timedatectl:

# Check current status
timedatectl status

# Set your timezone (e.g., America/New_York, Europe/London, Australia/Sydney)
sudo timedatectl set-timezone <Region/City>

(Raspberry Pi users can also use sudo raspi-config -> Localisation Options -> Timezone)

Generate your preferred locales (e.g. en_US.UTF-8 or en_GB.UTF-8):

# Multiple selections are allowed
sudo dpkg-reconfigure locales

(Raspberry Pi users can also use sudo raspi-config -> Localisation Options -> Locale)

The recommended installation method for Raspberry Pi OS, Debian, and Ubuntu is via the official APT repository at apt.indi-allsky.org. Pre-built .deb packages bundle all dependencies, Python virtual environments, and consolidated INDI camera drivers for an automated installation.

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://apt.indi-allsky.org/key.gpg | \
  sudo gpg --dearmor -o /etc/apt/keyrings/indi-allsky.gpg
sudo chmod a+r /etc/apt/keyrings/indi-allsky.gpg

sudo tee /etc/apt/sources.list.d/indi-allsky.sources <<EOF
Types: deb
URIs: https://apt.indi-allsky.org
Suites: $(lsb_release -cs)
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/indi-allsky.gpg
EOF

sudo apt update
sudo apt install -y indi-allsky

During installation, an interactive setup wizard will guide you through configuring your camera driver, administrator credentials, and observatory coordinates.

For development environments or unsupported platforms, you can clone the git repository and run the setup script:

1. (Optional) Setup locales:

   sudo dpkg-reconfigure locales

2. Install git:

   sudo apt-get update
   sudo apt-get install -y git

3. Clone the git repository:

   git clone https://github.com/aaronwmorris/indi-allsky.git
   cd indi-allsky/

4. Run setup.sh to install the system:

   ./setup.sh

5. Start the software:

   systemctl --user start indi-allsky

6. Open the web interface: https://<device-ip>/ (or https://raspberrypi.local/).

If you are using Option 2 (Manual Source Installation), INDI must be compiled using the bundled build script:

./misc/build_indi.sh

indi-allsky includes a script for compiling INDI from source. The script is completely self-contained and automated.

./misc/build_indi.sh

The script requires an Internet connection to download packages and the source from GitHub.

If you plan on using a libcamera supported camera module, you only need to compile the core INDI library (without the 3rd party libraries and drivers). This can reduce your compile time by 50%

WARNING: If you do this, the 3rd party indiserver drivers for ZWO, Player One, Touptek, etc will NOT be built.

An indiserver-only installation deploys the INDI driver server and camera drivers on a remote single-board computer or dedicated camera node, without the indi-allsky capture process or web interface.

1. Add GPG Keyring:

   sudo mkdir -p /etc/apt/keyrings
   curl -fsSL https://apt.indi-allsky.org/key.gpg | \
     sudo gpg --dearmor -o /etc/apt/keyrings/indi-allsky.gpg
   sudo chmod a+r /etc/apt/keyrings/indi-allsky.gpg

2. Add Repository Source (DEB822 format):

   sudo tee /etc/apt/sources.list.d/indi-allsky.sources <<EOF
   Types: deb
   URIs: https://apt.indi-allsky.org
   Suites: $(lsb_release -cs)
   Components: stable
   Architectures: $(dpkg --print-architecture)
   Signed-By: /etc/apt/keyrings/indi-allsky.gpg
   EOF

3. Install indiserver & drivers:

   sudo apt update
   sudo apt install -y indi-bin indi-3rdparty

1. Install git:

   sudo apt-get update
   sudo apt-get install -y git

2. Clone the git repository:

   git clone https://github.com/aaronwmorris/indi-allsky.git
   cd indi-allsky/

3. Run indiserver_only_setup.sh to install indiserver:

   ./misc/indiserver_only_setup.sh

   [!NOTE] The setup script will inform you if you are required to build the INDI software from source using ./misc/build_indi.sh.

1. Stop indi-allsky service:

   systemctl --user stop indi-allsky

2. Activate the indi-allsky Python virtual environment:

   source virtualenv/indi-allsky/bin/activate

3. Start indi-allsky:

   ./allsky.py run

The indi-allsky system consists of three services:

The web-only install is intended for remote configuration to use the SyncAPI on a VPS or central server where no camera is directly connected.

1. Add GPG Keyring:

   sudo mkdir -p /etc/apt/keyrings
   curl -fsSL https://apt.indi-allsky.org/key.gpg | \
     sudo gpg --dearmor -o /etc/apt/keyrings/indi-allsky.gpg
   sudo chmod a+r /etc/apt/keyrings/indi-allsky.gpg

2. Add Repository Source (DEB822 format):

   sudo tee /etc/apt/sources.list.d/indi-allsky.sources <<EOF
   Types: deb
   URIs: https://apt.indi-allsky.org
   Suites: $(lsb_release -cs)
   Components: stable
   Architectures: $(dpkg --print-architecture)
   Signed-By: /etc/apt/keyrings/indi-allsky.gpg
   EOF

3. Install indi-allsky-web:

   sudo apt update
   sudo apt install -y indi-allsky-web

1. Install git:

   sudo apt-get update
   sudo apt-get install -y git

2. Clone the git repository:

   git clone https://github.com/aaronwmorris/indi-allsky.git
   cd indi-allsky/

3. Run web_only_setup.sh to install the web interface:

   ./misc/web_only_setup.sh

4. Login to the indi-allsky web application: https://<device-ip>/ (or https://hostname/)

   [!NOTE] The web server is configured with a self-signed certificate by default.

5. On an internet-facing system, you can set up a signed certificate using Let's Encrypt or a similar service. Certificate locations can be updated at /etc/apache2/sites-enabled/indi-allsky.conf (or equivalent Caddy/Nginx configuration).