source: lxqt/desktop/post-install.xml@ 787a2e75

<?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="lxqt-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="lxqt-post-install">
    <primary sortas="g-lxqt-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"/>, and
      <xref linkend="dbus"/>
    </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;

cp -v {$LXQT_PREFIX,/usr}/share/xsessions/lxqt.desktop &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

ldconfig</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"/>. The <filename>lxqt.desktop</filename>
      file needs to be fixed, or will not be listed in <xref linkend="sddm"/>
      and <xref linkend="lxdm"/>:
    </para>

<screen role="root"><userinput>sed -e '/TryExec/d' \
    -i /usr/share/xsessions/lxqt.desktop</userinput></screen>

    <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 another vt<emphasis>n</emphasis> simultaneously
      pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
      (<emphasis>n</emphasis>=1, 2, ...).  To switch back to the X session,
      normally started at vt7, use Ctrl-Alt-F7. The vt where the command
      <command>startx</command> was executed will display many messages,
      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
      the initial vt uncluttered, but can also be used for debug purposes. This
      can be done starting X with:
    </para>

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

    <note>
      <para>
        You may wish to drop consolekit and/or dbus-launch, e.g., just using
        startlxqt in ~/.xinitrc. However some capabilities such as mounting or
        umounting file systems from a file manager will not be possible, or the
        reboot option will be absent or inoperative, among other problems.
      </para>
    </note>

    <para>
      When shutting down or rebooting, the shutdown messages appear on the vt
      where X was running. If you wish to see those messages, simultaneously
      press keys Alt-F7 (assuming that X was running on vt7).
    </para>

  </sect2>

</sect1>