====== X: Choose Your Desktop ======

Quickly and efficiently stand up X Windows with a working window manager or full desktop environment on %%FreeBSD%%.

===== Disk Requirements =====

| jwm | 1.0 GB |
| Fluxbox | 1.9 GB |
| Mate | 2.5 GB |
| Xfce4 | 2.6 GB |
| Lumina | 2.6 GB |
| Gnome3 | 3.3 GB |
| KDE | 5.8 GB |

===== TODO =====

  * cure the bland wiki page with ...
    * color
    * screen shots

===== Notation and Convention =====

Commands to be run as 'root' will be prefixed with a pound sign or hash.

<code>
# whoami
root
</code>

Commands to be run as an ordinary user will be prefixed with a dollar sign.

<code>
$ whoami
ordinary
</code>

This will help make clear to you the required privilege level needed for each command. This page does not assume 'sudo' or 'doas' has been enabled so it uses 'su -'
to show how and when to switch to 'root'. In the commands given below, the user name 'ordinary' is given to represent the login you intend to use for normal daily work. Substitute your own user name when following these instructions. In summary, the two usernames you will see are 'root' and 'ordinary'.

===== Prerequisites =====

:!: The instructions below assume a tier one architecture, some RAM (2GB+) and free disk space with a fresh install of 12.1-RELEASE. As this is a fresh install, you should update the base install and reboot at least once.

<code>
$ su -
(enter root password)
# freebsd-update fetch
# freebsd-update install
# reboot
</code>

After reboot and login, you can verify your kernel with these commands:

<code>
$ freebsd-version
$ uname -a
</code>

===== Desktop Installer =====

If you want a DE or WM with all the bells and whistles, use desktop-installer. It's very thorough. If you want a full DE experience without much effort, this is the way to go.

More details here:

[[unitrunker/desktop-installer|desktop-installer]]

|  Supported DEs  ||
| Cinnamon | Fluxbox |
| Gnome | %%IceWM%% |
| KDE | LXQT |
| Lumina | Mate |
| Window Maker | Xfce |

===== JWM =====

<%%<%%screenshot>>

Joe's Window Manager is one of the lightest WMs I've seen. Instructions on how to set it up:

[[unitrunker/JWM|JWM]]

===== Lumina =====

<%%<%%screenshot>>

These instructions will install [[https://svnweb.freebsd.org/ports/head/x11/lumina/pkg-descr?revision=HEAD|lumina]].

<code>
$ su -
(enter root password)
# pkg install xorg lumina
# pw groupmod video -m ordinary
# pw groupmod wheel -m ordinary
# pwd_mkdb -p /etc/master.passwd
(drop out of root)
# exit
$ start-lumina-desktop
</code>

Of all the X environments described - Lumina was the simplest and fastest to install.

More information here: [[https://lumina-desktop.org/|Lumina]]

Oh but wait! Technically you have a working X environment but there's no acceleration. Let's fix that now.
Exit your X session (select "Leave" from the Lumina menus) and then skip ahead to [[unitrunker/Acceleration|Acceleration]].

===== Acceleration =====

After you've set up your WM or DE, take advantage of your machine's built-in GPU acceleration.

[[unitrunker/Acceleration|Acceleration]]

----

{{tag>HowTo}}