Follow the steps mentioned on the KISS Linux website, making a few changes:
- Download the latest GKISS tarball from https://github.com/gkisslinux/grepo/releases instead of the KISS tarball.
- 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 addexport LANG=en_US.UTF-8
to/etc/profile
. - Optionally, enable the GKISS Community repository for software like
dbus
andpulseaudio
.
NOTE: This assumes that the user trusts the source of the binary packages. The packages are built on the author's personal system with these build flags.
Regularly updated binaries are provided for the following packages:
- Clang
- CMake
- Firefox
- LLVM
- Rust
Binaries for KISS (musl) -> here
- Modify
KISS_PATH
such that thebin
repository takes priority over other repositories:
export KISS_PATH=/path/to/grepo/bin:$KISS_PATH
- The packages can now be installed by a simple
kiss b $PKG
command.
TIP: mesa
can be built without llvm
on NVIDIA systems, look here for an example.
TIP: X11 Packages can be found in the kiss-xorg repo if Wayland is not for you.
- Modify
KISS_PATH
such that thenvidia
repository takes priority over other repositories since some Wayland packages likewlroots
are forked here to add NVIDIA support:
export KISS_PATH=/path/to/grepo/nvidia:$KISS_PATH
-
Build
libglvnd
, and thenmesa
since NVIDIA drivers require libglvnd. -
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
Any build failures/segfaults encountered with packages from GKISS/KISS repositories should be reported in the form of an issue on this repository.