Xur

Network settings and answer YAML.

Set a static address before installation, or change wired networking from the console or browser.

Configure an adapter

Open Settings → IP addresses → Manage automatic and static IPs, or choose Network settings in the console. Choose an adapter by its interface and MAC address. IPv4 and IPv6 each support automatic, static and disabled modes.

For a static address, include the prefix length, such as 192.0.2.10/24. Add a gateway and DNS servers if needed. Apply the draft, reconnect at the new HTTPS address, and choose Keep settings within two minutes. Otherwise the old connection returns automatically. The local console can also keep or revert a change.

Prepare an answer file

Download example xur.yml. Replace the example MAC, addresses, DNS and bootstrap code. These IPs are reserved for documentation and will not connect your machine to your network.

schemaVersion: 1
bootstrapToken: A7K-2M9
network:
  interfaces:
    - macAddress: "02:00:00:00:00:10"
      ipv4:
        method: manual
        addresses: [192.0.2.10/24]
        gateway: 192.0.2.1
        dns: [192.0.2.53]
      ipv6:
        method: auto

Place one xur.yml or xur.yaml at the root of a configuration USB drive. Do not include both names. Xur scans storage read-only and protects the configuration disk from erasure. Multiple answers, invalid fields or an adapter that cannot be identified leave installation locked.

The bootstrap code is optional; omit it to use the random code on the console. You may match an adapter by interface, but its MAC is preferable when interface names might change. Each IP family accepts auto, manual or disabled. Static mode requires a list of CIDR addresses; gateway and DNS are optional.

Review the disk before installing

The answer file does not approve disk erasure. After networking is ready, open the console's HTTPS address, create the manager account, select the target disk and approve installation. Internet access is required to download Bazzite. The saved network profiles carry into the installed system; the answer file and bootstrap code do not.

Answer networking is kept automatically after successful activation. Interactive changes require confirmation. If answer networking fails, correct the file and reboot to rescan.

Full field reference and API examples · Installation guide