Skip to content

Latest commit

 

History

History
68 lines (45 loc) · 2.65 KB

README.md

File metadata and controls

68 lines (45 loc) · 2.65 KB
Raw

GKISS Linux 🐂

Downloads

Installation

Follow the steps mentioned on the KISS Linux website, making a few changes:

REPODIR="$HOME/Repos" # Example, set this accordingly

export KISS_PATH=""
KISS_PATH="$KISS_PATH:$REPODIR/grepo/core"
KISS_PATH="$KISS_PATH:$REPODIR/grepo/extra"
KISS_PATH="$KISS_PATH:$REPODIR/grepo/wayland"
KISS_PATH="$KISS_PATH:$REPODIR/community/community"

  • In order to rebuild glibc, the KISS Community repository needs to be enabled.

  • Generate locales by running locale-gen as root after modifying the /etc/locale.gen file with the appropriate locales separated by newlines (en_US.UTF-8 UTF-8 for most users) and add export LANG=en_US.UTF-8 to /etc/profile.

NVIDIA

TIP: mesa can be built without llvm on NVIDIA systems, look here for an example.

  • Install the nvidia drivers by building the nvidia package.

  • For kernel configuration, refer to the Gentoo Wiki. The nouveau kernel module must either be blacklisted from being loaded or disabled in the kernel configuration.

  • The kernel modules can also be built for a specific kernel by exporting the KERNEL_UNAME variable:

export KERNEL_UNAME=5.10.2 # Example
kiss b nvidia
# Environment variables can't be used in `post-install`.
depmod "$KERNEL_UNAME"
  • For Wayland compositors to work properly, the NVIDIA kernel module MUST be loaded with the GSP firmware (To avoid flickering) and the modeset parameter enabled:
# tee /etc/rc.d/nvidia.boot <<EOF
/bin/modprobe nvidia NVreg_OpenRmEnableUnsupportedGpus=1 NVreg_EnableGpuFirmware=1 NVreg_EnableGpuFirmwareLogs=1
/bin/modprobe nvidia-drm modeset=1
EOF

If the firmware was loaded correctly, the following command should output the driver version instead of N/A:

$ nvidia-smi -q | grep GSP
    GSP Firmware Version                  : 515.48.07
  • Additionally, disable hardware cursors for wayland compositors to avoid flickering by adding the following command to ~/.profile:
export WLR_NO_HARDWARE_CURSORS=1

Reporting Issues

Any build failures/segfaults encountered with packages from GKISS/KISS repositories should be reported in the form of an issue on this repository.