GNOME: Difference between revisions

From Alpine Linux
(added troubleshooting -> /var/log/lxdm.log)
m (Extra step that helped me launching session from GDM)
(17 intermediate revisions by 7 users not shown)
Line 1: Line 1:
= Initial setup =
= Initial setup =
{{Warning|This document has yet to be fully tested}}
Start by booting up Alpine (see [[Installation|these]] instructions on how to do that)<BR>
Start by booting up Alpine (see [[Installation|these]] instructions on how to do that)<BR>
When you Alpine is up and running, do the initial setup.
When you Alpine is up and running, do the initial setup.
{{Cmd|setup-alpine}}
{{Cmd|# setup-alpine}}
{{Cmd|# setup-xorg-base}}


Add either the v2.2 or the edge repo
= Installing packages =
{{Cmd|echo "http://dl-3.alpinelinux.org/alpine/v2.2/packages/main" >> /etc/apk/repositories}}
Install basic desktop system and gnome packages. As of right now, these are in the testing repo.<BR>
OR
This might take a few minutes depending on your network speed.
{{Cmd|echo "http://dl-3.alpinelinux.org/alpine/edge/packages/main" >> /etc/apk/repositories}}
{{Cmd|# apk add gnome}}
<BR>


= Install packages =
If you want to you can also install additional GNOME apps for a more complete GNOME experience with:<BR>
Install basic desktop system and gnome packages.<BR>
{{Cmd|# apk add gnome-apps}}
This might take a few minutes depending on your network speed.  
<BR>
{{Cmd|apk add alpine-desktop gnome-base}}
 
== Setting up udev ==
You'll have to enable udev in order for GNOME to function properly.
 
{{Cmd|# apk add udev
# /etc/init.d/udev start && /etc/init.d/udev-trigger start && /etc/init.d/udev-settle start
# rc-update add udev sysinit
# rc-update add udev-trigger sysinit
# rc-update add udev-settle sysinit
}}
 
== Setting up Xorg ==
Even when using GNOME Wayland you'll still need a setup Xorg for XWayland.


== Optional packages ==
=== Video packages ===
=== xfce packages ===
You <u>might</u> also want to install a package suitable for your video chipset and input devices.<BR>
For example, if you have an Sis video chipset install 'xf86-video-sis', for Intel video chipset install 'xf86-video-intel'.<BR>
{{Cmd|apk add xf86-video-sis}}
and / or
{{Cmd|apk add xf86-input-synaptics}}


Run 'apk search xf86-video*' to see available xf86-video packages.<BR>
{{cmd|$ apk search xf86-video}}
Run 'apk search xf86-input*' to see available xf86-input packages.<BR>


=== acpid ===
Then install the driver matching to your card, e.g. if you have an Intel iGPU:
If you installed your Alpine Linux as a VirtualBox or VMWare guest you might find it handy be able send ACPI shutdown.<BR>
{{Cmd|rc-update add acpid}}


= Configure xorg-server (optional) =
{{cmd|# apk add xf86-video-intel}}
You can configure xorg-server and make your modifications
{{Cmd|Xorg -configure}}
This will result in `/root/xorg.conf.new`. You can modify this file to fit your needs.<BR>
(When finished modifying and testing the above configuration file, move it to `/etc/X11/xorg.conf` for normal usage.)


== udev ==
=== Input packages ===
Adding udev might help you with some finicky hardware like touchpads.
{{Cmd|apk add udev
/etc/init.d/udev start && /etc/init.d/udev-postmount start
rc-update add udev sysinit
rc-update add udev-postmount default
}}
Adding evdev might also be necessary, for example if the keyboard doesn't work in X...
{{Cmd|apk add xf86-input-evdev}}


= Create user accounts =
Usually libinput is the best choice, as it's integrated best with GNOME and offers advanced functionality (e.g. palm rejection for touchpads).
Create a normal user account.
{{Cmd|adduser ncopa}}


Optionally, give that user sudo permissions in /etc/sudoers.
{{cmd|# apk add xf86-input-libinput}}


= Start your desktop =
= Starting your desktop =
Start lxdm and log in with your new user.
Start GDM and login with your user.
{{Cmd|rc-service lxdm start}}
{{Cmd|rc-service gdm start}}


Once you have verified that it actually works you can make lxdm start up at boot:
Once you have verified that it actually works you can make gdm start up at boot:
{{Cmd|rc-update add lxdm}}
{{Cmd|rc-update add gdm}}


= Troubleshooting =
= Troubleshooting =
If you are unable to login, check /var/log/lxdm.log, there may be output there from X to indicate failed modules, etc.
If you are unable to login, check /var/log/gdm/greeter.log, there may be output there from X to indicate failed modules, etc.
 
If logging in from GDM returns to logging screen, try {{cmd|# apk add bash}} (bug report: #10953 sorry cannot link yet)
 
[[Category:Desktop]]

Revision as of 14:54, 14 November 2019

Initial setup

Start by booting up Alpine (see these instructions on how to do that)
When you Alpine is up and running, do the initial setup.

# setup-alpine

# setup-xorg-base

Installing packages

Install basic desktop system and gnome packages. As of right now, these are in the testing repo.
This might take a few minutes depending on your network speed.

# apk add gnome


If you want to you can also install additional GNOME apps for a more complete GNOME experience with:

# apk add gnome-apps


Setting up udev

You'll have to enable udev in order for GNOME to function properly.

# apk add udev

  1. /etc/init.d/udev start && /etc/init.d/udev-trigger start && /etc/init.d/udev-settle start
  2. rc-update add udev sysinit
  3. rc-update add udev-trigger sysinit
  4. rc-update add udev-settle sysinit

Setting up Xorg

Even when using GNOME Wayland you'll still need a setup Xorg for XWayland.

Video packages

$ apk search xf86-video

Then install the driver matching to your card, e.g. if you have an Intel iGPU:

# apk add xf86-video-intel

Input packages

Usually libinput is the best choice, as it's integrated best with GNOME and offers advanced functionality (e.g. palm rejection for touchpads).

# apk add xf86-input-libinput

Starting your desktop

Start GDM and login with your user.

rc-service gdm start

Once you have verified that it actually works you can make gdm start up at boot:

rc-update add gdm

Troubleshooting

If you are unable to login, check /var/log/gdm/greeter.log, there may be output there from X to indicate failed modules, etc.

If logging in from GDM returns to logging screen, try

# apk add bash

(bug report: #10953 sorry cannot link yet)