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
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.

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://path.to/omni?bcwe7r8236r7gwuyiwe"
      },
      {
        "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"
      }
  ]
}