|author||Chloe Kudryavtsev <firstname.lastname@example.org>||2018-12-31 21:19:42 -0500|
|committer||Chloe Kudryavtsev <email@example.com>||2018-12-31 21:19:42 -0500|
Add graphical environment instructions
1 files changed, 24 insertions, 0 deletions
diff --git a/modules/Working/pages/post-install.adoc b/modules/Working/pages/post-install.adoc
index f442f08..cf7c23a 100644
@@ -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.