diff options
-rw-r--r-- | modules/Working/pages/post-install.adoc | 24 |
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 --- a/modules/Working/pages/post-install.adoc +++ b/modules/Working/pages/post-install.adoc @@ -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. |