<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="kde-core-config" xreflabel="Starting KDE">
  <?dbhtml filename="config.html"?>

  <sect1info>
    <othername>$LastChangedBy: bdubbs $</othername>
    <date>$Date: 2015-03-03 22:53:57 -0500 (Tue, 03 Mar 2015) $</date>
  </sect1info>

  <title>Starting KDE</title>

  <bridgehead renderas="sect3">KDE Startup Dependencies</bridgehead>

  <bridgehead renderas="sect4">Optional</bridgehead>
  <para role="optional">
    <xref linkend="dbus"/> (runtime)
  </para>

  <para>After <application>Kde-workspace</application> has been installed, the
  first important milestone has been reached. Now you need to configure your
  system to start KDE.</para>

  <sect2 role="content">
  <title>Starting KDE from the command prompt</title>

 <para>To start <application>KDE</application> from the command prompt, you
 first need to modify your <filename>.xinitrc</filename> file:</para>

<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; EOF
<literal># Begin .xinitrc

exec ck-launch-session dbus-launch --exit-with-session startkde

# End .xinitrc</literal>
EOF</userinput></screen>

    <note><para>If you are not using <application>ConsoleKit</application>, remove
    <userinput>ck-launch-session</userinput>.</para></note>

    <para>You can now start KDE using the <command>startx</command> command.</para>

    </sect2>

    <sect2 role="content">
    <title>Starting KDE at boot</title>

    <para>KDE comes with a graphical login interface called KDM (the KDE Display
    Manager), which provides a customizable graphical login at boot. To use KDM,
    you need to edit your <filename>/etc/inittab</filename> file (as the
    <systemitem class="username">root</systemitem> user).
    First, setup run-level 5 to start KDM (adjust
    the path to kdm according to your system):</para>

<screen><userinput>cat &gt;&gt; /etc/inittab &lt;&lt; EOF
<literal>kd:5:respawn:/opt/kde/bin/kdm</literal>
EOF</userinput></screen>

    <para>Additionally, you need to change the default run-level from 3 to 5:</para>

<screen><userinput>sed -i 's#id:3:initdefault:#id:5:initdefault:#' /etc/inittab</userinput></screen>

    <para>You can now restart your system and see the KDE login
    screen.</para>

  </sect2>

  <sect2 role="content">
    <title>Installing further languages (l10n)</title>

    <para>You may want to install support for your locale language. The l10n
    packages can be found at <ulink
    url="&kde-download-http;applications/&kde-apps-version;/src/kde-l10n/">
         &kde-download-http;applications/&kde-apps-version;/src/kde-l10n/</ulink>.
    See <xref linkend="kde-add-pkgs"/> for build instructions. If you are in a
    KDE session when installing a new language and configure KDE to use it, the
    session needs to be restarted, in order to see the effects.</para>

  </sect2>

  <sect2 role="content">
    <title>Installing further KDE packages</title>

    <para>Every subsequent package can be built while having
    <application>KDE</application> up and running, but remember to keep
    <envar>&kde-dir;</envar> and <envar>&qt4-dir;</envar> set.</para>

  </sect2>

</sect1>
