Skip to main content

Troubleshooting

Common problems and what to do about them.

The installer menu just sits there

That is expected. The menu does not start on a timer — select an entry with the arrow keys and press Enter. See Installation.

The installation percentage does not change for a while

The percentage is an estimate, not an exact measurement. Installing drivers, Steam, and its runtime takes the longest, so the bar deliberately slows down near the end. If the indicator is animated and elapsed time keeps increasing, the installer is still working.

Do not power the computer off or remove the USB drive. Installation is complete only at the 100% / "Installation complete" screen. A regular image then powers the computer off; remove the USB drive after power-off. If a test image starts rebooting instead, you may remove the drive during that reboot. Do not remove it before the automatic shutdown begins.

The installer opens again after the installation

The computer booted from the USB drive again. Power it off, remove the drive, power it on. If that does not help, pick the internal SSD/NVMe in the Boot Menu instead of USB.

The installation failed

The screen shows a localized description, support code, and stage. What to do:

  1. Take a photo of the whole screen.
  2. Read the error — it is shown in the selected language and usually explains which step broke.
  3. Try installing again — some failures are one-offs.
  4. If the error comes back, send both photos to support.

The two most common causes: the internet dropped during installation, or Secure Boot was left on. Check the cable; if you installed over Wi-Fi, plug in a cable — Wi-Fi in the installer does not always work.

Black screen after installation, the desktop never appears

Almost always the graphics card.

  • Driver profile: leave it on Automatic. The installer selects Open on RTX 50xx (Blackwell) and newer cards, and Proprietary (Closed) on other supported NVIDIA GPUs.
  • RTX 50xx (Blackwell): Proprietary (Closed) is unavailable for these cards because the system cannot start graphics with it.
  • After changing the profile: the installer reinstalls the driver and the computer must then be rebooted.
  • The monitor is plugged into the motherboard instead of the graphics card: move the cable to the card.

No network after installation

Turn Secure Boot off: the network driver is built on the machine itself and is unsigned, and Secure Boot only loads signed modules. This is the usual cause of "no network" and "no graphics" on a fresh system.

Check that the cable is in the motherboard's port and that there is a link on the other end.

The key is rejected

Open the license list in the bot. Installation only works with an active license. The statuses "Expired", "Revoked", "Suspended" and "Inactive" will not let you through.

If the license is active but the key still does not work, it may already be bound to another computer. Reset the license in the bot: it issues a new key and disconnects the old machine.

The panel does not start or behaves strangely

Escalate gradually:

  1. Reboot the computer. Stop the farm first, then perform a normal system reboot.
  2. CleanUp under Settings → Maintenance — stops the panel's and Steam's background processes. If a game is running or any slots are active, CleanUp refuses to run; stop farming first.
  3. Reinstall the panel in the installer — reinstalls the panel without touching the system.
  4. Reset installed data — a full cleanup of the panel's data. See Reset and reinstall.

What to send to support

Support lives in Telegram.

Logs on the machine:

FileWhat is inside
/home/farm/panel/resources/backend/farm_gui.logthe main panel log
/var/log/sevapanel-installer.logthe Seva Installer
/var/log/seva-ansible.logthe initial system setup
/var/log/seva-network-preflight.logthe network check on install

If the panel is locked by the license, the lock screen has a "Copy details" button and a support code — that is the most useful thing to attach.