Troubleshooting
The problems people actually meet, in the order they usually meet them.
The computer ignores the USB stick
Open the boot menu at startup (often F12, F9, Esc or Del) and select the USB device explicitly. If it still does not appear, write the ISO again with a different tool (see the installation guide) and try another USB port.
The screen goes black or the display is garbled
Reboot, and in the GRUB menu press e, add nomodeset at the end of the line starting with linux, then press Ctrl+X. If that fixes it, the graphics driver needs attention after installing — ask in the Discord community with your graphics card model.
No Wi-Fi after installing
Check the physical wireless switch or Fn key first. Then connect by cable, run sudo apt update && sudo apt upgrade, and reboot. If it persists, note your card model (from lspci) and ask for help — a matching firmware package usually exists.
The installer stops with an error
Note the exact message and the step where it happened. The most common causes are a faulty USB write (rewrite the ISO and verify the checksum) and a disk with failing health. The community can help you read the error.
No sound
Click the speaker icon in the panel and confirm the right output device is selected and not muted. The full mixer is in the PulseAudio volume control in the menu.
Forgotten password
At the GRUB menu, edit the boot entry and add init=/bin/bash to the linux line, boot, then run mount -o remount,rw / and passwd your-username. Reboot normally afterwards.
Basalt Linux