GNOME: Difference between revisions

From Alpine Linux
(Mention that gdm needs a user available)
 
(38 intermediate revisions by 15 users not shown)
Line 1: Line 1:
= Initial setup =
 
Start by booting up Alpine (see [[Installation|these]] instructions on how to do that)<BR>
= Prerequisites =
When you Alpine is up and running, do the initial setup.
 
{{Cmd|# setup-alpine}}
* [[Installation|Install]] AlpineLinux
{{Cmd|# setup-xorg-base}}
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]


= Installing packages =
= Installing packages =
Install basic desktop system and gnome packages. As of right now, these are in the testing repo.<BR>
This might take a few minutes depending on your network speed.
{{Cmd|# apk add gnome}}
<BR>


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.
{{Cmd|# apk add gnome-apps}}
{{Cmd|# setup-desktop gnome}}
<BR>


== Setting up udev ==
It will take care of installing the basic packages and setting up the display manager.  
You'll have to enable udev in order for GNOME to function properly.


{{Cmd|# apk add udev
If you want, you can install additional GNOME apps for a more complete GNOME experience with:
# /etc/init.d/udev start && /etc/init.d/udev-trigger start && /etc/init.d/udev-settle start
{{Cmd|# apk add gnome-apps-extra}}
# rc-update add udev sysinit
# rc-update add udev-trigger sysinit
# rc-update add udev-settle sysinit
}}


== Setting up Xorg ==
And even all of GNOME games with:
Even when using GNOME Wayland you'll still need a setup Xorg for XWayland.
{{Cmd|# apk add gnome-games-collection}}


=== Video packages ===
= Enabling GNOME Shell screen recording =
For the embedded screen recording in GNOME Shell to work, you will need some additional packages: {{cmd|# apk add pipewire wireplumber gst-plugin-pipewire}}


{{cmd|$ apk search xf86-video}}
= Enabling GNOME Software =
For GNOME Software to be able to manage APK packages, it needs the <code>apk-polkit-server</code> service working. To enable it and start it up:
{{cmd|# rc-update add apk-polkit-server default && rc-service apk-polkit-server start}}


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


{{cmd|# apk add xf86-video-intel}}
If you are unable to log in, check /var/log/gdm/greeter.log, there may be info there from X that indicates failed modules, etc.


=== Input packages ===
If GNOME Terminal doesn't start, add the following to /etc/profile.d/locale.sh: <code>LANG=en_US.UTF-8</code> and reboot.


Usually libinput is the best choice, as it's integrated best with GNOME and offers advanced functionality (e.g. palm rejection for touchpads).
If the on-screen keyboard shows up in GDM after installing other UIs such as Phosh, you need to disable it by opening the Accessibility menu (top right) when you are in the GDM login screen. You can disable the on-screen keyboard there. Or set <code>org.gnome.desktop.a11y.applications screen-keyboard-enabled</code> to <code>false</code> for the <code>gdm</code> user with <code>dconf</code>


{{cmd|# apk add xf86-input-libinput}}
== Slow applications or rendering issues ==


= Starting your desktop =
Please note that some applications, i.e. Gnome Web (Epiphany), may require the installation of libraries related to hardware acceleration to work correctly.  
Start GDM and login with your user. You need a user other than root for this to succeed, since GDM will refuse starting if no user accounts (meaning accounts with a UID >= 1000) are available.
{{Cmd|rc-service gdm start}}


Once you have verified that it actually works you can make gdm start up at boot:
In quite some cases, this can be solved by installing <code>mesa-gles</code> (OpenGL ES). Check if you you have issues loading the shared library <code>libGLESv2.so.2</code>. If so, you can install it with:
{{Cmd|rc-update add gdm}}


= Troubleshooting =
{{Cmd|# apk add mesa-gles}}
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)
== See also ==
* [https://wiki.archlinux.org/title/GNOME GNOME - Archwiki]
* [https://wiki.gentoo.org/wiki/GNOME GNOME - Gentoo Wiki]
* [https://wiki.postmarketos.org/wiki/GNOME GNOME - PostmarketOS Wiki]


[[Category:Desktop]]
[[Category:Desktop]]
[[Category:Desktop Environments]]

Latest revision as of 21:50, 28 November 2023

Prerequisites

Installing packages

Install basic desktop system and gnome packages.

# setup-desktop gnome

It will take care of installing the basic packages and setting up the display manager.

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

# apk add gnome-apps-extra

And even all of GNOME games with:

# apk add gnome-games-collection

Enabling GNOME Shell screen recording

For the embedded screen recording in GNOME Shell to work, you will need some additional packages:

# apk add pipewire wireplumber gst-plugin-pipewire

Enabling GNOME Software

For GNOME Software to be able to manage APK packages, it needs the apk-polkit-server service working. To enable it and start it up:

# rc-update add apk-polkit-server default && rc-service apk-polkit-server start

Troubleshooting

If you are unable to log in, check /var/log/gdm/greeter.log, there may be info there from X that indicates failed modules, etc.

If GNOME Terminal doesn't start, add the following to /etc/profile.d/locale.sh: LANG=en_US.UTF-8 and reboot.

If the on-screen keyboard shows up in GDM after installing other UIs such as Phosh, you need to disable it by opening the Accessibility menu (top right) when you are in the GDM login screen. You can disable the on-screen keyboard there. Or set org.gnome.desktop.a11y.applications screen-keyboard-enabled to false for the gdm user with dconf

Slow applications or rendering issues

Please note that some applications, i.e. Gnome Web (Epiphany), may require the installation of libraries related to hardware acceleration to work correctly.

In quite some cases, this can be solved by installing mesa-gles (OpenGL ES). Check if you you have issues loading the shared library libGLESv2.so.2. If so, you can install it with:

# apk add mesa-gles

See also