View source for FreeBSD/Setup

== Setup ==

To install the current official release, get [[{{PAGENAME}}/Ports|ports or packages]].

To install the bleeding edge, get [[{{PAGENAME}}/Area51|area51]].

Once you have installed whichever version of KDE you like (official ports of KDE4, or KDE Frameworks, Plasma Workspace and Applications from area51, as of early 2017), there are a few more steps to get it running, which we try to list here.

== X Window System ==

To use KDE Software Compilation on FreeBSD, [http://www.x.org X.Org] is required. If you still dont't have it, you'll need to [http://www.FreeBSD.org/doc/en/books/handbook/x-install.html install] and [http://www.FreeBSD.org/doc/en/books/handbook/x-config.html configure] it properly.

== Other Dependencies ==

You should have the following packages installed and configured:

; DBus:

<code>service dbus start</code>

; HAL:

<code>service hald onestart</code>

; procfs:

* [https://www.freebsd.org/doc/en/articles/linux-users/procfs.html FreeBSD Handbook (Article):''FreeBSD Quickstart Guide for Linux® Users''/''procfs: Gone But Not Forgotten'']

Without them, either KDE software won't run, or you won't have a keyboard and mouse in the X Window System, which reduces its usefulness considerably.

== Starting KDE4 ==

After installing KDE workspace (`x11/kde4-workspace`) either via ports or packages, you can add `kdm4_enable="YES"` to `/etc/rc.conf` to boot into KDE Plasma Desktop via KDM, the KDE Display Manager.

== Starting KDE Plasma 5 Workspace ==

After installing KDE Plasma 5 Workspace (`x11/plasma5-plasma-workspace`) either via ports or packages, you must also install SDDM.

= rewrite =

: by [[User:Vater|Vater]] ([[User talk:Vater|talk]]) 18:02, 3 January 2019 (UTC)

== Installing ==

The easiest way to get KDE running (on nearly every FreeBSD box) is to install the KDE binary packages from the standard FreeBSD repository.
: [[#Installing by using the Binary Package Management]]

An other way to install the KDE is to compile it from (FreeBSD) ports.
: [[#Installing by using the FreeBSD Ports Collection]]

And you can also install by cloning and compiling sources directly like for Area 51.
: [[#Installing by using the sources for the FreeBSD Port]]

=== Installing by using the Binary Package Management ===
[https://www.freebsd.org/doc/handbook/pkgng-intro.html FreeBSD Handbook:''Installing Applications: Packages and Ports''/''Using pkg for Binary Package Management]

The default repository for binary packages on FreeBSD is ''quarterly''. An alternate repository for FreeBSD is ''latest'' provided from FreeBSD as well.
: [[#Changing the binary packages repository]]

It is recommended to install and use ([[#X.Org minimal]] or) [[#X.Org minimal]].

It is recommended to install and use [[#SDDM]].

==== Installing the small stack of [https://www.kde.org/plasma-desktop KDE Plasma] only ====

Installing the binary package [https://www.freshports.org/x11/plasma5-plasma/ x11/plasma5-plasma] (KDE5 plasma meta port)
: <code>pkg ins -y plasma5-plasma</code>
Installing the (recommended) binary package [https://www.freshports.org/x11/xorg-minimal/ x11/xorg-minimal] (X.Org minimal distribution metaport)
: <code>pkg ins -y xorg-minimal</code>
Optional <small>(To have a first terminal emulator.)</small> installing the (recommended) binary package [https://www.freshports.org/x11/konsole/ x11/konsole]
: <code>pkg ins -y konsole</code>

==== Installing a basic stack of KDE ====

Installing the binary package [https://www.freshports.org/x11/kde-baseapps/ x11/kde-baseapps] (KDE5 baseapps meta port)
: <code>pkg ins -y kde5</code>
Installing the (recommended) binary package [https://www.freshports.org/x11/xorg-minimal/ x11/xorg-minimal] (X.Org minimal distribution metaport)
: <code>pkg ins -y xorg-minimal</code>

==== Installing the full stack of KDE ====

Installing the binary package [https://www.freshports.org/x11/kde5/ x11/kde5] (KDE Plasma Desktop and Applications (current))
: <code>pkg ins -y kde5</code>
Installing the (recommended) binary package [https://www.freshports.org/x11/xorg/ x11/xorg] (X.Org complete distribution metaport)
: <code>pkg ins -y xorg</code>

==== Changing the binary packages repository ====

On FreeBSD are a lot of useful tools that optional can be use. For example there is <code>[https://www.freebsd.org/cgi/man.cgi?query=beadm beadm]</code> (package ''[https://www.freshports.org/sysutils/beadm sysutils/beadm]''), a tool to create create and manage ZFS snapshots of your system (independent from your home directory data).

===== Checking the binary packages repository =====

Optional printing the standard configuration file for the pkg binary package management (to the standard output)
: <code>cat /etc/pkg/FreeBSD.conf</code>
On a default FreeBSD you should get the following.
<pre></pre>
<pre>
FreeBSD: {
  url: "pkg+http://pkg.FreeBSD.org/${ABI}/quarterly",
  mirror_type: "srv",
  signature_type: "fingerprints",
  fingerprints: "/usr/share/keys/pkg",
  enabled: yes
}
</pre>

Optional checking the standard directory for custom configurations of the pkg binary package management and printing all configuration files in the standard directory for custom repositories of the pkg binary package management (to the standard output)
: <code>ls /local/etc/pkg/ && cat /local/etc/pkg/repos/*</code>
On a default FreeBSD you should get the following.
<pre>
ls: /local/etc/pkg/: No such file or directory
</pre>

===== Changing the binary packages repository quick & dirty =====

Replacing ''<nowiki>pkg+http://pkg.FreeBSD.org/${ABI}/quarterly</nowiki>'' with ''<nowiki>pkg+http://pkg.FreeBSD.org/${ABI}/latest</nowiki>'' in the standard configuration file for the pkg binary package management
: <code><nowiki>sed -i '' -e 's/pkg.FreeBSD.org\/\${ABI}\/quarterly/pkg.FreeBSD.org\/\${ABI}\/latest/g' /etc/pkg/FreeBSD.conf</nowiki></code>

Updating all (currently) installed binary packages
: <code>pkg upg -y</code>

===== Changing the binary packages repository the exemplary FreeBSD way =====

=== Installing by using the FreeBSD Ports Collection ===
[https://www.freebsd.org/doc/handbook/ports-using.html FreeBSD Handbook:''Installing Applications: Packages and Ports''/''Using the Ports Collection'']

=== Installing by using the sources for the FreeBSD Port ===

== Dependencies ==

=== SDDM ===

SDDM is highly recommended to get KDE running easily. (So you can avoid same problems. SDDM helps to choose the right Screen<!-- ''DISPLAY'' variable --> for example.)

=== Installing SDDM by using the Binary Package Management ===

Installing the binary package  [https://www.freshports.org/x11/sddm x11/sddm]
: <code>pkg ins -y sddm</code>

Installing the (recommended) binary package [https://www.freshports.org/x11/xorg-minimal x11/xorg-minimal]
: <code>pkg ins -y xorg-minimal</code>

Starting the service ''sddm'' once
: <code>service sddm onestart</code>
Stopping the service ''sddm'' once
: <code>service sddm onestop</code>

Enabling the service ''sddm'' for system starts
: <code>sysrc sddm_enable=yes</code>
Starting the (enabled) service ''sddm'' now
: <code>service sddm start</code>

; additional packages:

Installing the binary package  [https://www.freshports.org/deskutils/plasma5-sddm-kcm deskutils/plasma5-sddm-kcm]
: <code>pkg ins -y plasma5-sddm-kcm</code>

Installing the binary package  [https://www.freshports.org/x11-themes/sddm-freebsd-black-theme x11-themes/sddm-freebsd-black-theme]
: <code>pkg ins -y sddm-freebsd-black-theme</code>

===== SDDM meets Ports =====

=== Problems ===

== See also ==

* [https://www.freebsd.org/doc/handbook/x11-wm.html#idp51996792 FreeBSD Handbook:''The X Window SystemDesktop''/''Environment''#''KDE'']