Home/Wiki

Basalt Linux Wiki

Documentation and guides for Basalt Linux.

Hardware Setup

Guide to configuring common hardware on Basalt Linux.

Wi-Fi & Networking

Click the network icon on the panel to connect to wireless networks. For troubleshooting:

  • Ensure your Wi-Fi adapter is supported (most modern adapters work out of the box)
  • Check if the interface is enabled: nmcli radio wifi
  • List available networks: nmcli dev wifi list
  • Connect via terminal: nmcli dev wifi connect <SSID> password <password>

For advanced network configuration, use nm-connection-editor or edit files in /etc/NetworkManager/system-connections/.

Graphics Drivers

Intel

Intel graphics work out of the box. For additional performance:

$ sudo apt install intel-media-va-driver

AMD

AMD graphics also work out of the box with the open-source driver:

$ sudo apt install mesa-va-drivers firmware-amd-graphics

NVIDIA

For NVIDIA graphics, install the proprietary driver:

$ sudo apt install nvidia-driver firmware-misc-nonfree

Reboot after installation. To check which driver is recommended for your card, use nvidia-detect:

$ sudo apt install nvidia-detect nvidia-detect

Printers

Open Settings > Printers to add a printer. Basalt Linux uses CUPS for printing:

  • Make sure your printer is connected and powered on
  • Click “Add Printer” and select your printer from the list
  • Choose the correct driver (most HP printers work with hplip)
  • Set as default printer if desired

For HP printers, install additional drivers:

$ sudo apt install hplip hplip-gui

Bluetooth

Bluetooth is supported via BlueZ. Click the Bluetooth icon on the panel or use Settings:

  • Ensure Bluetooth is enabled on your device
  • Put the target device in pairing mode
  • Select the device from the list and click “Pair”

From the terminal:

$ bluetoothctl power on scan on pair <device-address> connect <device-address>

Audio

Audio typically works out of the box. Volume can be adjusted from the speaker icon on the panel. For advanced audio configuration:

$ sudo apt install pavucontrol    # Audio volume control pavucontrol

USB Devices

USB drives, cameras, and other devices are automatically detected. Use Thunar to access USB drives. For unrecognized devices, check system logs:

$ dmesg | tail -20 lsusb