Overview

The Cyolo Launcher is a management layer for deploying and operating Cyolo platform components on Alpine Linux machines. It provides a web-based setup wizard for initial configuration and an operations dashboard for ongoing management.

Supported Platforms

Components

The Launcher can deploy and manage the following Cyolo components:

• IDAC -- Identity & Access Control
• Private Gateway -- Edge routing and TLS termination
• Connector -- Connects private resources to the Cyolo platform
• Fabric Controller -- Network segmentation

Architecture Overview

The Launcher runs as an OpenRC service (cyolo-launcher) on Alpine Linux. It consists of:

• Backend: Go service called launcherd that manages component lifecycle, configuration, metrics collection, and log aggregation
• Frontend: A React-based web UI served on port 8080, accessed via SSH tunnel
• Wrapper: lightweight process that spawns launcherd, and respawns it after launcherd’s own auto-upgrade

The Launcher is distributed as a self-extracting shell script (install.sh) that bundles the Cyolo-launcher-system APK along with all Alpine package dependencies. This allows installation on machines where access to services.cyolo.io is not available before the Launcher’s setup has been run.

Installation

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.

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

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