Introduction

The Cyolo Launcher is installed on Alpine Linux using a self-extracting shell script. The installer bundles the Launcher system APK and all Alpine package dependencies into a single file. No network access is required during installation.

📘
Note
Why is the installer self-contained?
Although Cyolo Launcher requires outbound connectivity to services.cyolo.io during operation, the installation process does not assume access to Alpine package repositories on the target machine

Prerequisites

Operating system: Alpine Linux 3.22 or 3.23
Architecture: x86_64 or aarch64
Privileges: Root access (the installer must run as root)
Disk space: Sufficient space for the Launcher and the selected Cyolo component

Download the Installer

The installer is hosted at deploy.cyolo.io and does not require a license to download.

From any machine with internet access, download the appropriate installer for your target machine’s Alpine version and CPU architecture.

Alpine 3.23

# x86_64
curl -fsSL https://deploy.cyolo.io/launcher/alpine-3.23/x86_64/latest -o install.sh

# aarch64
curl -fsSL https://deploy.cyolo.io/launcher/alpine-3.23/aarch64/latest -o install.sh

Alpine 3.22

# x86_64
curl -fsSL https://deploy.cyolo.io/launcher/alpine-3.22/x86_64/latest -o install.sh

# aarch64
curl -fsSL https://deploy.cyolo.io/launcher/alpine-3.22/aarch64/latest -o install.sh

Pinning a specific version

To download a specific version instead of latest, replace latest with the version tag:

curl -fsSL https://deploy.cyolo.io/launcher/alpine-3.23/x86_64/v1.2.3 -o install.sh

URL pattern

https://deploy.cyolo.io/launcher/alpine-{version}/{arch}/{release}

Where:

{version} is the Alpine version: 3.22 or 3.23
{arch} is the CPU architecture: x86_64 or aarch64
{release} is either latest or a pinned version such as v1.2.3

Run the Installer

Transfer the installer to the target Alpine machine if it was downloaded elsewhere, then run it as root:

# Transfer to target machine (if needed)
scp install.sh root@<target-host>:/tmp/install.sh

# Run the installer
sh /tmp/install.sh

The installer extracts its bundled packages and installs them locally. No network access is used during this step.

Installer Options

Option	Description
`--help`	Show usage information
`--info`	Display embedded version, architecture, and Alpine version without installing
`--extract`	Extract the payload to `./cyolo-launcher-payload/` without installing

Example:

sh install.sh --info
# Cyolo Launcher Installer
#   Version:      1.2.3
#   Architecture: x86_64
#   Alpine:       3.23

Post-Installation

Verify the service is running

rc-service cyolo-launcher status

Access the Launcher UI

The Launcher UI listens on port 8080 on localhost. To access it from your workstation, open an SSH tunnel:

ssh -L 8080:localhost:8080 root@<launcher-host>

Then open your browser to:

http://localhost:8080

If the Launcher has not been configured, the Setup Wizard is displayed. Otherwise, the Operations Dashboard is shown.

Check service logs

tail -f /var/log/cyolo-launcher/launcher.log

Uninstallation

To completely remove the Launcher:

rc-service cyolo-launcher stop
apk del cyolo-launcher-system