XurNetwork settings and answer YAML.
Configure Wi-Fi or wired IP settings from the console, or from the web manager after installation. An answer file can supply wired settings before installation.
Configure an adapter
Open Settings → Manage Wi-Fi and IP settings, or choose Network settings in the console. Choose a wired 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.
Connect to Wi-Fi
After installation, open Settings → Manage Wi-Fi and IP settings → Wi-Fi. Enable Wi-Fi if needed, choose Scan for networks for an adapter, select an SSID and connect. Open, WPA2-Personal and WPA3-Personal networks are supported; hidden, WEP and enterprise networks require separate configuration. Passwords are cleared after submission. A successful connection is saved for automatic reconnection.
Changing the connection carrying your browser session can disconnect it. Reconnect at the new address and refresh its status. Wi-Fi connection changes do not use the wired IP editor's two-minute rollback window.
Choose Network settings → Wi-Fi setup in the console. Select an adapter if more than one is present, choose an SSID, and enter its password when prompted. Password input is hidden. Open, WPA2-Personal and WPA3-Personal networks are supported. Successful connections are saved for reboot and installation.
The initial setup boot also asks for the server name. Save it once; it carries into the installed host. Change it later through the console's Server name entry.
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: autoPlace 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, select and review the target disk in the console, then choose Yes to confirm erasure (No is the default). After reboot, open the displayed HTTPS address and enter the console code to create the required administrator account. Chrome or your password manager can suggest and save a strong password. Internet access is required to download Bazzite. The saved network profiles carry into the installed system; the answer file does not. Its optional bootstrap code is carried privately for post-install account creation, then deleted.
Answer networking is kept automatically after successful activation. Interactive changes require confirmation. If answer networking fails, correct the file and reboot to rescan.