Skip to content

How-to guide to install with Talos OS

Talos can be installed using two methods

  • Talos install vanilla: provide required siderolink.api link
  • Talos install via Factory image: provide required factoryhash

In both cases, additional kernel parameters are required. These will override any defaults injected.

Talos default kernel parameters are: 

slab_nomerge
pti=on
vga=normal
locale=en_US
console-keymaps-at/keymap=us
net.ifnames=0
panic=0
initrd=initrd.magic
init_on_alloc=1
consoleblank=0
nvme_core.io_timeout=4294967295
nvme_core.multipath=n
printk.devkmsg=on
ima_template=ima-ng
ima_appraise=fix
ima_hash=sha512
talos.platform=metal
talos.events.sink=[fdae:41e4:649b:9303::1]:8091
talos.logging.kernel=tcp://[fdae:41e4:649b:9303::1]:8092

More information about Talos kernel parameters you can find here: https://www.talos.dev/v1.7/reference/kernel/

Network configuration for your server will be automatically injected by our systems.

Classic nic names vs predictable nic names

The kernel parameter net.ifnames=0 will disable predictable network interface names and revert to classic names like eth0, eth1, etc.

This works in most cases where a server only has 1 or 2 uplinks. If you have more than 2 uplinks and network configuration is failing, it can be that Talos is assigning the wrong interfaces to eth0 and / or eth1. In that case you can try using the "predictable interface names" solution, by using the kernel parameter net.ifnames=1.

Example Talos OS 1.7.7 Vanilla Request Body

POST /v3/flexMetal/servers

Request body 

{
  "name": "MyTalosServer",
  "location": "EU: Rotterdam",
  "instanceType": "bm7.std.8",
  "os": {
    "slug": "talos-omni-177",
    "kernelParams": [
      {
        "key": "siderolink.api",
        "value": "https://siderolink.api/?jointoken=secret"
      },
      {
        "key": "talos.customparam",
        "value": "123456"
      }
    ]
  }
}

Example Talos OS 1.7.7 Factory Request Body

POST /v3/flexMetal/servers

Request body 

{
  "name": "MyTalosServer",
  "location": "EU: Rotterdam",
  "instanceType": "bm7.std.8",
  "os": {
    "slug": "talos-omni-177",
    "kernelParams": [
      {
        "key": "factoryhash",
        "value": "93be9c834b04065cdfb6223049697263586e92471231ed2abdfcc23c2a4551a4"
      },
      {
        "key": "talos.customparam",
        "value": "123456"
      }
    ]
  }

}