Commit a8913a5e authored by Chloe Kudryavtsev's avatar Chloe Kudryavtsev

Add graphical environment instructions

parent 45deba7c
......@@ -57,3 +57,27 @@ sudo command with arguments <5>
<3> The wheel group mentioned above is the common "administrator" group, and since we're using it, we need to add our user to said group.
<4> You may need to log out and log back in for the group listing to update. `sudo -i` is the equivalent of `su -` otherwise.
<5> This will run "command with arguments" as the default `sudo` user - root.
== Getting a Graphical Environment
// MAINT: alpine-desktop, alpine-conf (setup-xorg-base)
Most people will often want something more than just a raw tty.
This section describes how to get a supported graphical interface, as well as some additional notes (for example, how to use a different type of GUI).
// TODO: link to acf
NOTE: You should *not* follow this if your system is intended to be used as a server, gateway, or similar device - those do not and should not require graphical interfaces. You can see the section acf if you absolutely require something more visual.
First, it is necessary to prepare the system - drivers are built into the linux kernel, but they are not accessible to the X Server - the windowing system provider.
On most hardware, you can do this quickly by running `setup-xorg-base`.
This will automatically detect what kind of gpu is installed, and install the appropriate xorg driver accelerator.
NOTE: If this does not work for you, or you encounter other issues, as per usual, feel free to ask for help in the official support channels.
// MAINT: alpine-desktop contents
Once that is done, you can install the recommended and supported graphical setup by installing (and thus running) `apk add alpine-desktop`.
This will install several system-related utilities, as well as the `lxdm` Desktop Manager and `xfce4` Desktop Environment.
In case you want a different DE or DM, you should install those now.
Once this is done, you should enable your chosen Desktop Manager as a service.
For `lxdm` this looks like so: `rc-update add lxdm` and `rc-service lxdm start`.
The first one makes it start on boot, and the last one will start it up immediately.
Markdown is supported
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment