Skip to content
← Documentation

Installing Heliont

Installation

Heliont is installed with the Heliont Installer. On Windows and macOS, download it from Downloads after signing in (the installer itself is free for verified accounts). On Linux servers you can curl the latest installer without signing in — see Linux CLI installation.

You also need:

  • A valid Heliont license file from your Licenses library (sign-in required; copy it to the server)
  • Docker Engine (and Compose) on the target machine

Choose the path that matches your system.

Windows (graphical installer)

  1. Download Heliont Installer for Windows from Downloads.
  2. Run the .exe and allow it through Windows security prompts if asked.
  3. Follow the wizard:
    • Select Install
    • Confirm Docker is ready
    • Provide your license file and accept the terms
    • Choose Online (downloads the pack) or Offline (point at a local pack)
    • Choose Local or Public access (see TLS certificates for public installs)
  4. When installation finishes, complete the Heliont web setup in your browser using the setup token shown in the installer.

macOS (graphical installer)

  1. Download Heliont Installer for macOS from Downloads and open the zip.
  2. Open Heliont Install. If Gatekeeper blocks it, right-click the app → Open.
  3. Walk through the same wizard steps as on Windows (Install → Docker → license → online/offline → access).
  4. Finish setup in the browser when the installer asks you to.

Docker Desktop must be installed and running before you continue past the Docker step.

Ubuntu / Linux Server (CLI)

For headless servers and SSH installs, follow the step-by-step guide:

Linux CLI installation

Quick start (prep folder with your license, then curl the installer):

mkdir -p ~/heliont-prep && cd ~/heliont-prep # copy heliont-license.json into this folder first

ARCH=$(uname -m) case "$ARCH" in x86_64) SLUG=linux-amd64 ;; aarch64|arm64) SLUG=linux-arm64 ;; *) echo "unsupported arch: $ARCH"; exit 1 ;; esac curl -fsSL -o "heliont-install-${SLUG}" "https://heliont.store/install/installer/${SLUG}" curl -fsSL -o "heliont-install-${SLUG}.sha256" "https://heliont.store/install/installer/${SLUG}/checksum" sha256sum -c "heliont-install-${SLUG}.sha256" chmod +x "heliont-install-${SLUG}" sudo ./"heliont-install-${SLUG}"

The Linux installer discovers the license (and optional pack/TLS files) from the current directory. See the full Linux guide for public domains, offline packs, custom install directories, and port overrides.

Linux desktop (GNOME)

A graphical installer experience for Linux desktops (including GNOME) is planned. Until then, use the Linux CLI installation steps on Linux machines.

After installation