GNOME: Difference between revisions

From Alpine Linux
No edit summary
(17 intermediate revisions by 7 users not shown)
Line 3: Line 3:


* [[Installation|Install]] AlpineLinux
* [[Installation|Install]] AlpineLinux
* [[Post_installation#Creating_a_new_user_account|Create a user account]] (optional but recommended)
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Post_installation#Repositories|Enable the Community repository]]
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]
 
{{Note|[[Wayland]] can be used but may be less stable and Gnome may still require Xorg}}


= Installing packages =
= Installing packages =


Install basic desktop system and gnome packages.
Install basic desktop system and gnome packages.
{{Cmd|# apk add gnome}}
{{Cmd|# 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:
If you want, you can install additional GNOME apps for a more complete GNOME experience with:
{{Cmd|# apk add gnome-apps-core}}
And further extra GNOME apps with
{{Cmd|# apk add gnome-apps-extra}}
{{Cmd|# apk add gnome-apps-extra}}


= Graphical login =
And even all of GNOME games with:
To start the GDM display manager and login with your user, you need a user other than root for this to succeed. GDM will refuse to start if no user accounts (accounts with a UID >= 1000) are available.
{{Cmd|# apk add gnome-games-collection}}
{{Cmd|rc-service gdm start}}


Once you have verified correct operation, you can make GDM start at boot:
= Enabling GNOME Shell screen recording =
{{Cmd|rc-update add gdm}}
For the embedded screen recording in GNOME Shell to work, you will need some additional packages: {{cmd|# apk add pipewire wireplumber gst-plugin-pipewire}}


= Enabling terminal apps =
= Enabling GNOME Software =
If you want to use the gnome-terminal/other terminal applications you will need to install bash. If you want a typical bash setup also enable bash completion:
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|# apk add bash}}
{{cmd|# rc-update add apk-polkit-server default && rc-service apk-polkit-server start}}
{{cmd|# apk add bash-completion}}


= Troubleshooting =
= Troubleshooting =
If GDM does not start with no logs generated at /var/log/gdm, try installing udev: {{cmd|apk add udev && rc-update add udev}}


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 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 logging in from GDM kicks you back to the login screen, try {{cmd|# apk add bash}} (bug report: #10953 sorry cannot link yet)
If GNOME Terminal doesn't start, add the following to /etc/profile.d/locale.sh: <code>LANG=en_US.UTF-8</code> 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 <code>org.gnome.desktop.a11y.applications screen-keyboard-enabled</code> to <code>false</code> for the <code>gdm</code> user with <code>dconf</code>
 
== 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 <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:


If GNOME Terminal doesn't start, add the following to /etc/locale.conf: LANG=en_US.UTF-8 and reboot.
{{Cmd|# apk add mesa-gles}}


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>
== 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]]

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