Home/Wiki

Wiki

Documentation and guides for Basalt Linux.

Troubleshooting

Common issues encountered with Basalt Linux and their solutions.

Boot Issues

System Does Not Boot from USB

  • Check boot order in BIOS/UEFI settings
  • Try a different USB port (USB 2.0 if available)
  • Re-write the ISO using a different tool
  • Disable Secure Boot temporarily
  • Disable Fast Boot in Windows if dual-booting

System Boots to Black Screen

  • At GRUB, press e to edit boot parameters
  • Add nomodeset to the kernel command line
  • Press Ctrl+X to boot
  • Once booted, install appropriate graphics drivers

Network Issues

Wi-Fi Not Working

  • Check if Wi-Fi is blocked: rfkill list
  • Unblock if needed: sudo rfkill unblock wifi
  • Ensure NetworkManager is running: sudo systemctl status NetworkManager
  • Check for proprietary drivers if using a Broadcom adapter

Ethernet Not Detected

  • Check cable connection
  • Verify interface: ip link show
  • Bring interface up: sudo ip link set <interface> up
  • Check driver: lspci -k | grep -A 3 Ethernet

Audio Issues

  • Check volume levels: alsamixer
  • Ensure correct output device in Settings > Sound
  • Restart the audio stack (PipeWire): systemctl --user restart pipewire pipewire-pulse
  • Check if audio is muted: amixer sget Master

Installation Issues

Calamares Fails to Install

  • Verify the ISO checksum — the download may be corrupted
  • Try a different USB drive
  • Check available disk space on target drive
  • Ensure at least 2 GB of RAM is available
  • Try manual partitioning if automatic fails

Dual Boot Not Showing Windows

  • Ensure Windows is fully shut down (not hibernated)
  • Disable Fast Startup in Windows power options
  • Run sudo update-grub after installation

Performance Issues

  • Check RAM usage: free -h or htop
  • Disable compositing in Settings > Window Manager Tweaks > Compositor
  • Reduce visual effects in Settings > Appearance
  • Check for background processes consuming resources
  • Consider an SSD for better responsiveness

Getting Help

If the above does not resolve your issue: