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

<?xml version="1.0" encoding="UTF-8"?>
<!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"?>

  <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>
      Please follow these instructions before starting
      <application>LXQt</application> for the first time.
    </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">
      <xref linkend="breeze-icons"/> and
      <xref linkend="desktop-file-utils"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="lightdm"/> or another Display Manager, e.g.
      <xref role="nodep" linkend="sddm"/>, and
      <xref linkend="xscreensaver"/>
    </para>

  </sect2>

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

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

      <para>
        The desktop databases need to be created or updated at this point.
        Run the following commands as the &root; user:
      </para>

<screen role="root"><userinput>ldconfig                             &amp;&amp;
update-mime-database /usr/share/mime &amp;&amp;
xdg-icon-resource forceupdate        &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="lightdm"/>.
    </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="lightdm"/>.
    </para>

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

<screen role="nodump"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
<literal>exec startlxqt</literal>
EOF

startx</userinput></screen>

    <para>
      The X session starts on the first unused virtual terminal, normally vt1.
      You can switch to another vt<emphasis>n</emphasis> by simultaneously
      pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
      (<emphasis>n</emphasis>=2, 3, ...).  To switch back to the X session,
      normally started at vt1, use Ctrl-Alt-F1. 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, but these
      are hidden by the graphical interface. You may prefer to redirect those
      messages to a log file, which can be used for debugging purposes. This
      can be done starting X with:
    </para>

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

  </sect2>

  <sect2>
    <title>Initial Configuration</title>

    <para>
      When LXQt first starts, it will ask you for the window manager to use.
      To start, the BLFS editors recommend using <application>openbox</application>.
      At this point both the background and the panel will be black.  Right clicking
      on the background will bring up a menu and selecting "Desktop Preferences"
      will allow you to change the background color or set a background image.
    </para>

    <para>
      The panel will be at the bottom of the screen.  Right clicking on the
      panel will bring up a menu that will allow you to customize the panel
      including adding widgets and setting the background color.  The BLFS 
      editors recommend installing, at a minimum, the Application Manager and
      Task Manager widgets.
    </para>

    <para>
      After LXQt has started for the first time, the BLFS editors recommend
      going through the settings presented in the LXQt Configuration Center,
      which can be found under LXQt Settings in the Preferences menu of the
      application launcher.
    </para>

    <note>
      <para>
         The user configuration files will be created in the directory
         $HOME/.config/lxqt/.  To get widget icons to display properly,
         the lxqt.conf file may need to be manually edited to include the
         line "icon_theme=oxygen".
      </para>
    </note>

  </sect2>
</sect1>