<chapter id="install">
<title>Installing &plasma-desktop; and &kde; Applications</title>

<para>You can install &kde; applications, including &plasma-desktop;, on a
variety of different platforms, ranging from
smartphones and tablets to computers running &Microsoft; &Windows;, &macOS;,
&UNIX;, &BSD; or &Linux;.  Binary packages are available for many different
platforms and distributions, or advanced users may build the source code.</para>

<sect1 id="install-packages">
<title>Installing Packages</title>

<para>Hundreds of developers worldwide have done a lot of work to make it easy
to install &kde; onto a variety of different devices and platforms.</para>

<sect2 id="install-linux">
<title>&Linux;</title>

<para>Nearly every &Linux; distribution provides binary packages for individual
applications and the &plasma-desktop; as a whole.</para>

<para>To install an individual application, look for its name in your
distribution's package collection.  To install one of the &plasma-workspaces;,
like &plasma-desktop;, look for a metapackage or package
group, typically <literal>plasma-desktop</literal>.</para>

<note>
<para>Some applications may be installed together with other
applications in a combined package named after the &kde; package they are
provided in. For instance, &konqueror; might be found in the
<literal>kde-baseapps</literal> package.</para>
</note>

<para>If you have trouble locating &kde; packages for your distribution, please
contact their support resources.  Many distributions also have a team dedicated
to packaging applications by &kde; that can provide assistance specific to them. </para>

<!--FIXME: provide steps for common distributions?-->

</sect2>

<sect2 id="install-windows">
<title>&Microsoft; &Windows;</title>

<para>The &kde; on Windows Initiative provides binary packages of &kde;
applications for &Microsoft; &Windows;.  They also provide a special installer
application that permits you to install individual applications or groups and
all necessary dependencies easily.</para>

<para>For more information on the initiative and to download the installer,
visit <ulink url="https://community.kde.org/Windows">the KDE on Windows Initiative</ulink>.
</para>

<!--FIXME: describe how to use the installer?-->

</sect2>

<sect2 id="install-mac">
<title>&macOS;</title>

<para>Individual &kde; applications can be installed through several
different <quote>ports</quote> systems available for &macOS;.  Several different
&kde; applications also provide their own binary builds for &macOS;.</para>

<para>For more information, visit
<ulink url="https://community.kde.org/Mac">&kde; on &macOS;</ulink>.</para>

</sect2>

<sect2 id="install-bsd">
<title>&BSD;</title>

<para>Most &BSD; distributions allows you to install &kde; applications
and the &plasma-desktop; through their <quote>ports</quote>
system.</para>

<para>For more information on installing ports, see your &BSD; distribution's
documentation.</para>

<!--FIXME: provide steps/links for common BSDs?-->

</sect2>

<sect2 id="install-mobile">
<title>Mobile Devices</title>
<para><productname>Plasma Mobile</productname> is an exciting initiative to bring a new &kde;
experience to mobile devices like smartphones or tablets.  Binary releases are
provided for several different devices.</para>

<para>For more information, visit
<ulink url="https://www.plasma-mobile.org/"><productname>Plasma Mobile</productname></ulink>.</para>

</sect2>

<sect2 id="install-live">
<title>Live Media</title>

<para>Several &Linux; and &BSD; distributions offer live media.  This permits you
to try out the &plasma-desktop; without installing anything to your system.
All you have to do insert a CD or connect a USB drive and boot from it.  If you
like what you see, most offer an option to install it to your hard drive.</para>

<para>There is <ulink url="https://www.kde.org/download/distributions.php">a list
of distributions that offer the &kde; workspace and applications on live media</ulink> on the &kde; website.</para>
</sect2>
<!--Neon?-->
<sect2 id="install-source">
<title>Building from Source Code</title>

<para>For detailed information on how to compile and install &plasma-desktop; and
applications see <ulink url="https://community.kde.org/Guidelines_and_HOWTOs/Build_from_source">Build from source</ulink>.</para>

<para>Since &kde; software uses <command>cmake</command> you should
have no trouble compiling it. Should you run into problems please report them to the
&kde; mailing lists.</para>

<para>The recommended tool to build Frameworks, &plasma-desktop; and all the other applications is
<ulink url="https://commits.kde.org/kdesrc-build">kdesrc-build</ulink>
</para>
</sect2>
<!--FIXME more info:
  Where to get sources (git split) 
  where to get help building from souces
  kdesrc-build
  -->

</sect1>

</chapter>
