source: lxqt/desktop/post-install.xml@ 1608f96

<?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"/>, or another window manager, such as
      <xref role="nodep" linkend="xfwm4"/>, or
      kwin from <xref role="nodep" linkend="plasma5-build"/>.
      Note that <xref role="nodep" linkend="icewm"/> is not suitable for LXQt
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <phrase revision="sysv">
        <xref linkend="consolekit"/> with
        <xref linkend="pm-utils"/>,
      </phrase>
      <xref linkend="sddm"/> (recommended by <application>LXQt</application>
      developers) or another Display Manager, e.g.
      <xref role="nodep" linkend="lxdm"/>,
      <xref linkend="desktop-file-utils"/>,
      <xref linkend="shared-mime-info"/>,
      <xref linkend="xdg-utils"/>, and
      <xref linkend="xscreensaver"/>
    </para>

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

  </sect2>

  <sect2 role="configuration">
    <title>Final Configuration</title>

    <para>
      If <application>LXQt</application> is installed in <filename
      class="directory">/usr</filename>, jump directly to <xref
      linkend="lxqt-final-updates"/>, otherwise run the commands in the
      next section.
    </para>

    <sect3>
      <title>Configuration needed only if installing into /opt</title>
      <para>
        If <application>LXQt</application> is installed into <filename
        class="directory">/opt</filename>, some files have to be copied to
        <filename class="directory">/usr/share</filename>, so that the system
        can find them. 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>

    </sect3>

    <sect3 id="lxqt-final-updates" xreflabel="LXQt Final Updates">
      <title>LXQt Final Updates</title>

      <para>
        The desktop databases have to be created or updated at this point.
        Run the following commands as the <systemitem
        class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>update-mime-database /usr/share/mime          &amp;&amp;
xdg-icon-resource forceupdate --theme hicolor &amp;&amp;
update-desktop-database -q</userinput></screen>

    </sect3>

  </sect2>

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

    <para revision="sysv">
      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 revision="systemd">
      You can start <application>LXQt</application> from a TTY, using
      <xref linkend="xinit"/>, or by using a graphical display manager such
      as <xref linkend="sddm"/>.
    </para>

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

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

startx</userinput></screen>

<screen revision="systemd"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
<literal>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 revision="sysv">
      <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>