CRUX : Home

Home :: Documentation :: Download :: Development :: Community :: Wiki :: Ports :: Bugs :: Links :: About

Back to wiki start page

Categories: Ports

KDE4 ports for CRUX

Authors: Alan Mizrahi

How to install a functional KDE4 environment in CRUX

Before Compilation

  1. Ensure the kde4 repository directory is included in your prt-get configuration by adding prtdir /usr/ports/kde4 in /etc/prt-get.conf
  2. I suggest you to configure pkgmk to ignore .footprint mismatches by setting PKGMK_IGNORE_FOOTPRINT=yes in /etc/pkgmk.conf
  3. If you have more than 1 computer I suggest you to set up distcc to reduce the compilation time. In addition to distcc, you may also want to use ccache.
  4. You may wish to disable certain components of KDE4 from being built.
    To do this, check the Pkgfiles. In each Pkgfile there is a DO_NOT_COMPILE variable that you may set with whatever you want to prevent from being built.
    I have written the corresponding possible values in each Pkgfile in order to make it easy.
  5. You may wish to check the optional dependencies before starting the compilation, they are documented later in this text file.


Just fire up prt-get with the modules you want to install: $ prt-get depinst kdebase kdepim kdegraphics kdenetwork kdemultimedia kdeutils

There are several external programs that are not part of the official KDE4 distribution, but they are included in the repository and you may install them too. For example: amarok, basket.


To use kdm as your login manager I advise you to follow these steps:

  1. cp -r /usr/share/config/kdm /etc/X11/
  2. Change your inittab to start kdm on runlevel 3, add this:
    x:3:respawn:/usr/bin/kdm -nodaemon -config /etc/X11/kdm/kdmrc
    Additionally, you will have to configure your inittab to run everything from runlevel 2 in runlevel 3, because CRUX by default doesn't define runlevel 3.
    Now if you are satisfied, make the default runlevel 3.
    My inittab looks like this:
    su:S:wait:/sbin/sulogin -p
    c1:123:respawn:/sbin/agetty 38400 tty1 linux
    c2:23:respawn:/sbin/agetty 38400 tty2 linux
    c3:23:respawn:/sbin/agetty 38400 tty3 linux
    c4:23:respawn:/sbin/agetty 38400 tty4 linux
    ca::ctrlaltdel:/sbin/shutdown -t3 -r now
    x:3:respawn:/usr/bin/kdm -nodaemon -config /etc/X11/kdm/kdmrc

Upgrading from KDE3

  1. While the CRUX KDE3 ports use ~/.kde to store the configuration files, the KDE4 ports use ~/.kde4 .
    Therefore, if you want KDE4 to migrate your old settings you can rename ~/.kde to ~/.kde4 , but I strongly suggest you make a backup first.
  2. If you used kopete in KDE3 and have been keeping chat logs from an MSN account, you will have to rename the directory holding your logs:
    mv ~/.kde4/share/apps/kopete/logs/MSNProtocol ~/.kde4/share/apps/kopete/logs/WlmProtocol


This document is work in progress. Please send suggestions or improvements to alan at mizrahi dot com dot ve