HomeGuides
Log In
Guides

Appliance Installation

This guide walks you through installing the Cyolo Appliance from an ISO image on a virtual or physical machine. At the end of the process, the appliance is running and accessible via its Web UI for further configuration.

Prerequisites

  • Hardware (or VM) that meets the Cyolo specification for CPU, RAM, and disk.
  • Access to a hypervisor or bare-metal machine where you can mount an ISO and boot from it.
⚠️

Data loss warning: The installation process wipes the target disk entirely. Ensure there is no data on the disk that you need before proceeding.

Step 1 — Download the ISO

Download the ISO for your target architecture:

Mount the downloaded ISO as a boot device on your VM or physical machine.

Step 2 — Boot and Install

  1. Power on the machine. The Cyolo installer boot screen appears.
  2. Press Enter to start the installation.
  3. When prompted, click Install to begin writing the appliance image to disk.
  4. Wait for the installation to complete. When it finishes, click Shut Down.

Step 3 — Detach the ISO

Before powering the machine back on, disconnect the ISO so the machine boots from disk rather than the installer:

  1. Open your VM settings (or the physical machine's boot configuration).
  2. Locate the ISO/CD-ROM drive and clear the ISO path.
  3. Save the settings.

Step 4 — First Boot and Login

Power on the machine. After boot, a login prompt appears.

Log in with the default credentials:

  • Username: cyolo-admin
  • Password: cyolo
🔒

Security notice: Change the default password during initial configuration in the next step.

Step 5 — Initial Configuration

After logging in, a setup wizard guides you through the following:

  1. Select your timezone.
  2. Select your language.
  3. Select the network interface to use.
  4. Configure the network settings (static IP or DHCP).
  5. Set the hostname and a new cyolo-admin password.

Step 6 — Continue via the Web UI

Once the initial configuration is saved, the terminal displays the appliance's Web UI address in the top-right corner of the screen.

Direct access

Open a browser on a machine that can reach the appliance and navigate to that address to complete the installation and onboarding through the Web UI.

ℹ️

If the Web UI address is not reachable, verify that your network settings from Step 5 are correct and that the machine's firewall allows inbound traffic on port 8080.

Via SSH tunnel

If direct access is not available, open a terminal and run the following command, replacing <machine-ip> with the appliance's IP address:

ssh -L 8080:127.0.0.1:8080 root@<machine-ip>

Then open a browser on the same machine and navigate to http://127.0.0.1:8080/

Updated about 1 month ago

Did this page help you?