Skip to content
Products
Platform
Developer Tools
Portal

Booting images

Introduction

Section titled “Introduction”

After you create a bootable medium for STACKIT Edge Cloud, the next step is to boot your host system from it. This guide walks you through the required steps using common examples.

Common boot methods

Section titled “Common boot methods”

You can use several methods to deliver the created medium to your target system.

  • Boot from an ISO file by:
    • Mounting the ISO using out-of-band management (OOBM).
    • Using a bootable USB device created from the ISO file.
  • Boot from a raw image by:
    • Using a pre-formatted medium, such as a MicroSD card.
    • Creating a virtual machine (VM) from the raw image.

The method you choose depends on your preferences and the boot options supported by your target platform.

Machine stages

Section titled “Machine stages”

Talos Linux uses multiple machine stages. The maintenance stage is the initial, temporary state of a Talos node. In this stage, the node has only the minimal configuration required for you to access its API (for example, with talosctl) and waits for you to apply its final configuration. At this stage, the host is not yet part of any Kubernetes cluster.

To learn more about the boot sequence, refer to the official Talos Linux documentation.

After you complete the steps in the first boot section, your STEC host should be in the maintenance stage. If it is not, review the common issues that often result in boot failures.

First boot

Section titled “First boot”

When you first boot your target device from the STEC image, you will see two bootloader entries. The default entry boots automatically after a few seconds and starts Talos Linux in maintenance stage.

Regular machines and VMs

Section titled “Regular machines and VMs”

  1. Start your target device from the STEC image. The bootloader menu appears, showing the available boot options.

    Talos Boot Menu - Reboot Countdown.

  2. The (optional) initial boot parameters can be modified by pressing the ‘e’ key on the selected bootloader entry. This may be useful for troubleshooting selected boot options.

    Talos Boot Menu - Boot into Firmware Interface.

  3. Allow the boot sequence to complete, which should only take a few seconds.

    Terminal Log Output during Talos Boot Process.

  4. Verify that the Talos dashboard loads.

    Confirm two things: the stage is maintenance and the connectivity is ok.
    Note the system UUID shown in the top-left corner of the dashboard. You will use this UUID in the next step to identify the host.
    Dashboard
    The dashboard runs on the second virtual TTY. The first virtual TTY shows kernel logs. You can switch between TTYs using the <Alt+F1> and <Alt+F2> keys. You can also use the <F1> through <Fn> keys to switch between different screens of the dashboard.

    Terminal Log Output during Talos Kubernetes Node Boot/Initialization.

Single board computers

Section titled “Single board computers”

The boot process for single board computers (SBCs) is very similar to that of regular machines and VMs and—given you have chosen the correct overlay image and followed the guidance for single board computers—should look similar to the process outlined in this Raspberry Pi 4b example.

  1. Insert your boot medium, e.g. MicroSD card, into your Raspberry PI and boot it.

    PiKVM Console Showing Raspberry Pi 4 Boot log.

  2. You should be presented with the u-boot bootloader. If you see this you know that the overlay has successfully been integrated into your boot image.

    PiKVM Console Showing U-Boot Initialization.

  3. The rest of the boot should be similar to the normal boot experience and you should see the standard GRUB bootloader screen that ships with Talos.

    Talos Boot Menu - GRUB Interface.

  4. On single-board computer (SBC) images (Talos Linux 1.9.x and newer), the interactive dashboard is disabled by default. You can enable it, if required, by adding the kernel parameter talos.dashboard.disabled=0.

    The dashboard runs on the second virtual TTY. The first virtual TTY shows kernel logs. You can switch between TTYs using the <Alt+F1> and <Alt+F2> keys. You can also use the <F1> through <Fn> keys to switch between different screens of the dashboard.

    PiKVM Console Showing Talos Boot Messages.

  5. In the STEC GUI you now should see that the new EdgeHost has successfully registered with the STEC instance.

    Prerequisite: You have authenticated access to a STEC instance.

    STACKIT Edge Cloud Dashboard - Single Host View.

Host registration

Section titled “Host registration”

Once your target system has booted into maintenance stage, it automatically idles and tries to register itself with the STEC management plane.

For registration to succeed, your host’s initial boot parameters must be configured to allow an HTTPS connection (TCP port 443) to *.stackit.cloud.

You can verify the successful registration in the STEC web UI or CLI by matching an identifier, such as the UUID (which you noted from the dashboard) or the MAC address of your target system.

Prerequisites

Before you begin, you need the following:

Steps

  1. Navigate to the hosts section of the GUI. You should see a new host matching the UUID seen in the Talos dashboard. The status should display “ready”.

    STACKIT Edge Cloud Dashboard - Hosts View.

  2. By clicking on the host name you can verify additional configuration data of the host.

    Screenshot of the STACKIT Edge Cloud web interface showing the details page for a Host.