Installation instructions for the KDE Desktop Environment 1.0

These are the installation instructions for the 1.0 release of the KDE Desktop Environment. Please read them carefully and try to help yourself out if anything goes wrong. If you need further assistance, consider joining the kde mailing lists (see our web site instructions for joining the kde mailing lists).

Available package formats

The KDE team provides six different kinds of packages: source and binary RPMs, source and binary .tgz files and source and binary Debian files. The source and binary RPMs will be available shortly after the release of KDE 1.0 on ftp.kde.org. The installation process depends on which package format you choose. After installation, there are post-installation procedures that apply for all package formats. Note that if you are an inexperienced Unix user and have a RPM-based system  you are probably best off choosing the binary RPM packages beeing provided by your distribution vendor.  At least Caldera, Delix and SuSE will make binary RPMs available via their ftp servers. If you need special configuration options (e.g. because you have shadow passwords and want to use the screensavers), your best bet is to use the source packages and compile the KDE Desktop Environment yourself.  Binary RPM packages for distributions which do not offer official KDE 1.0 packages are made available via the contrib section of ftp.kde.org as soon as they are available.

Distributions providing their own set of binaries for KDE 1.0

Soon after the release of KDE 1.0 you can get customized sets of binary rpms from the following sources.
 

Vendor

Vendors ftp server

mirror on KDEs ftp server
Caldera ftp.caldera.com ftp.kde.org
Delix ftp.delix.de ftp.kde.org 
S.u.S.E. ftp.suse.com ftp.kde.org 
FreeBSD  ftp.freebsd.org 
 

Prequisites

You need the Qt library (and header files if you want to compile KDE yourself), version 1.33 or higher, available at no cost from http://www.troll.no/dl. You also need the libgr which should be included in most distributions. Please make also sure that your local loopback device is setup correctly.

Available packages

The base distribution currently consists of nine packages. Some are required, some are optional. Each package is available in each of the aforementioned package formats. kdesupport (if needed) should be installed before everything else. The next (or first) package should be kdelibs. The other packages can be installed in an arbitrary order.

Installation instructions for the different package formats

Installation of the Debian packages

The Debian packages install  according to the upcoming FHS (file hierarchy standard).

To install the Debian package:

and accordingly for the other packages

Installation of the RPM packages

The RPM packages install into /opt/kde.

To install the binary RPM:

To create a binary RPM from the source rpm and install it do the following:

Installation of the source .tar.gz files

The source .tgz package installs into /usr/local/kde per default. You can override this setting by using the --prefix option of the configure script.

Installation of the binary .tgz files

The binary .tgz package installs into /opt/kde.

Post-installation procedures

First of all, make sure that you have added KDE's binary installation directory (e.g. /opt/kde/bin) to your PATH and KDE's library installation directory to your LD_LIBRARY_PATH (only necessary on systems that do not support rpath; on Linux ELF, it should work without) this environment variable may be called differently on some systems, e.g. it is called SHLIB_PATH on Irix). Then set the environment variable KDEDIR to the base of your KDE tree, e.g. /opt/kde.

Even though you can use most of the KDE applications simply by calling them, you can only benefit fully from KDE's advanced features if you use the KDE window manager kwm and its helper programs.

In order to make it easy for you, we have provided a simple script called startkde which gets installed in $KDEDIR/bin and is therefore in your path. Edit the file .xinitrc in your home directory (make a backup copy first!), remove everything that looks like calling a window manager, and insert startkde instead. Restart X. This should present you with your shining new KDE desktop. You can now start to explore the wonderful world of KDE. In case you want to read some documentation first, there is a highly recommended quickstart guide available. Also, every application has an online help that is available via the help menu.

NO WARRANTY

[This text taken from the GPL.]
BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Reporting bugs

Please report bug reports to kde-bug report site where they will be distributed to the developer in charge. If you do not have web access please sent your report to  kde-bugs@kde.org .

Have fun with KDE ,
--The KDE Core team