Logo Wael's Digital Garden

Talos - Generate ISO and Installer with Custom Extensions via Image Factory

Talos Linux provides an Image Factory to generate customized installation images. For a bare-metal or Proxmox installation, a "metal" platform image can be generated.

Process Example using web interface (v1.10.2):#

  1. Go to the Talos Linux Image Factory.
  2. Select architecture (e.g., amd64), platform (metal), desired Talos version (e.g., 1.10.2).
  3. Specify desired system extensions. For example, to include nfsd, qemu-guest-agent, and tailscale:
customization:
    systemExtensions:
        officialExtensions:
        - siderolabs/nfsd
        - siderolabs/qemu-guest-agent
        - siderolabs/tailscale
  1. The factory will generate a unique schematic ID and an installation URL for the ISO. Example URL: factory.talos.dev/metal-installer/630b5c0ccc1955f97a7c6f097fd5eae789d10a425fed8431985e22bf7a831af2:v1.10.2

This ISO can then be downloaded and used to install Talos on Proxmox VMs or physical hardware.

Process Example using command line and schematic file (v1.10.2):#

  1. Write a schematic.yaml that describe the customization (the same yaml from the section above).
  2. Send a POST request to https://factory.talos.dev/schematics and it should return the schematic ID

ISO#

The ISO (for ProxmoxVE - VM - Talos Linux - New Kubernetes Cluster) can be obtained from the following URL:

https://factory.talos.dev/image/{{ schematic ID }}/{{ Talos version }}/metal-amd64.iso

For example

https://factory.talos.dev/image/84f66f3fa52900a0234636ae1da07d5b356cce774673951af35866142158fce6/v1.10.2/metal-amd64.iso

Install or Upgrade#

The installer (can be used for initial installation and update) and is given to the talos gen config command, and it can be constructed like this

factory.talos.dev/metal-installer/{{ schematic ID }}:{{ Talos version }}

For example

factory.talos.dev/metal-installer/84f66f3fa52900a0234636ae1da07d5b356cce774673951af35866142158fce6:v1.10.2

Related:#

Source#