Quick Start Guide

This guide takes a fresh installation to its first reinstalled server. It assumes the panel is running and licensed (Installation of TrixOS).

1. Secure your account

Sign in as the administrator you created and open Profile & security in the menu under your name (top right). Turn on two-factor authentication (any TOTP app works) and change the generated password.

2. Add a datacenter

Datacenters are called sites in TrixOS. Open System → Agents, add one with a name and, optionally, its address. If the servers of this site should install over PXE, install a site agent for it now: Install agent gives you a one-time command for the agent host.

Racks are optional. Add them under Datacenters when you want rack views and labels (Datacenters, racks & labels).

3. Add a server

Open Servers → Add server and enter at least the hostname, the site and the MAC address of the NIC that PXE-boots. Then open the server and fill in the BMC card (Configure): type (IPMI, Redfish or a vendor), address, user name and password.

The server’s power state appears within a few seconds. N/A means TrixOS can’t reach the BMC or has no credentials for it; the server page shows the reason.

4. Assign a public IPv4 address

Under IP addresses, add the subnet the server lives in (network, prefix length, gateway, DNS resolvers) and assign an address to the server from its IPs tab. PXE jobs need a public IPv4 address on the server, because the installer configures it in the new system.

5. Live or dry-run

A panel installed with the script runs in live mode: power actions and installs reach the BMC. A source installation starts in dry-run mode: jobs run through every step but only log what they would send. Settings shows which one is active. Switch with TRIXOS_ALLOW_DESTRUCTIVE in .env:

sed -i 's/^TRIXOS_ALLOW_DESTRUCTIVE=.*/TRIXOS_ALLOW_DESTRUCTIVE=true/' .env
docker compose up -d

See Safety switches.

6. Collect hardware information

On the server’s Inventory tab, choose Rescan via PXE. The server boots a small live system over PXE, reports its CPUs, memory, disks, NICs, BIOS and SMART data and powers off. It’s a safe first test of the whole PXE path: BMC, boot override, DHCP and TFTP from the agent, the boot files and the callback. If it hangs, the job page shows where (PXE diagnosis).

For a server that is already running Linux, Discover (no reboot) gives you a one-line command that collects the same data without a reboot.

7. Install an operating system

On the Reinstall tab, pick an OS profile and a disk layout, set a root password or SSH keys and confirm with the server’s hostname. The job page shows every step and the installer’s log. When the install finishes, the server powers off, TrixOS switches its boot order back to disk and powers it on.

Next steps

• Add your switches under Network to map ports to servers and graph bandwidth (Network & bandwidth).
• Create customer accounts and API tokens (Users, roles & API tokens).
• Add webhooks for failed jobs and unhealthy disks (Notifications).
• Set up backups.