source: lxqt/desktop/post-install.xml@ eca7a58

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter 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="post-install" xreflabel="LXQt-Post-Install">
  <?dbhtml filename="post-install.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>LXQt Desktop Final Instructions</title>

  <indexterm zone="post-install">
    <primary sortas="a-post-install">LXQt-post-install</primary>
  </indexterm>

  <sect2 role="package">
  <title>Post-Install Instructions</title>

    <para>
      Final steps, before starting <application>LXQt</application>.
    </para>

    <bridgehead renderas="sect3">Dependencies to Start LXQt</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="openbox"/> (runtime) - this may be replaced by
      another WM, see the Configuring instructions in <xref
      linkend="lxqt-session"/>.
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="consolekit"/> alone or with
      <xref linkend="sddm"/> (this has been
      reported as the <quote>recommended <application>LXQt</application>
      display manager</quote>) or another Display Manager, e.g.
      <xref linkend="lxdm"/>.
    </para>

    <para condition="html" role="usernotes">
      User Notes: <ulink url="&blfs-wiki;/post-install"/>
    </para>

  </sect2>

  <sect2 role="final-config">
    <title>Final configuration</title>

    <para>
      If installed in /usr, you do not need final configuration. Jump to
      <quote>Starting LXQt</quote>, below.
    </para>

    <para>
      If installed in /opt, in order for the system to find some files, run the
      following commands, as the <systemitem class="username">root</systemitem>
      user:
    </para>

<screen role="root"><userinput>ln -svfn $LXQT_PREFIX/share/lxqt /usr/share/lxqt &amp;&amp;

for i in $LXQT_PREFIX/share/applications/*
do
  ln -svf $i /usr/share/applications/
done

for i in $LXQT_PREFIX/share/desktop-directories/*
do
  ln -svf $i /usr/share/desktop-directories/
done

unset i</userinput></screen>

  </sect2>

  <sect2 role="starting">
    <title>Starting LXQt</title>

    <para>
      You can start <application>LXQt</application> from runlevel 3, using
      <xref linkend="xinit"/>, or from runlevel 5, using a Display Manager,
      such as <xref linkend="sddm"/>.
    </para>

    <para>
      To start <application>LXQt</application> using <xref linkend="xinit"/>,
      run the following commands:
    </para>

<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
<literal>ck-launch-session dbus-launch --exit-with-session startlxqt</literal>
EOF

startx</userinput></screen>

    <para>
      The X session starts on the first unused virtual terminal, normally vt7.
      You can switch to a vtn (n=1, 2, ...) simultaneously pressing the keys
      Ctrl-Alt-Fn. To switch back to the X session, normally started at vt7,
      use Ctrl-Alt-F7. If started from vt1 (the usual case), you will see many
      messages there, including X starting messages, applications automatically
      started with the session, and eventually, some warning and error
      messages. You may prefer to redirect those messages to a log file, which
      not only will keep vt1 uncluttered, but also can be used for debug
      purposes. This can be done starting X with:
    </para>

    <screen><userinput>startx &amp;&gt; ~/.x-session-errors</userinput></screen>

    <para>
      You may wish to drop consolekit and/or dbus-launch, e.g., just using
      startlxde in .~/.xinitrc, but some functionalities such as mount/umount
      file systems from a file manager will not be possible, or the reboot
      option will be absent or not functioning, between other problems.
    </para>

    <para>
      Because X is (normally) on vt7, when you shutdown the vt is switched back
      to that one where the command starting it was executed. In this case, if
      you wish to see the shutdown messages, simultaneously press keys Alt-F7,
      because normally those messages appear on the vt where X was running.
    </para>

  </sect2>

</sect1>