GNOME: Difference between revisions
m (→Troubleshooting: added to DE category) |
|||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 5: | Line 5: | ||
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended) | * [[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]] | * [[Repositories#Enabling_the_community_repository|Enable the Community repository]] | ||
= Installing packages = | = Installing packages = | ||
| Line 21: | Line 18: | ||
And even all of GNOME games with: | And even all of GNOME games with: | ||
{{Cmd|# apk add gnome-games-collection}} | {{Cmd|# apk add gnome-games-collection}} | ||
= Enabling GNOME Shell screen recording = | = Enabling GNOME Shell screen recording = | ||
| Line 35: | Line 27: | ||
= Troubleshooting = | = 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 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 | 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: | |||
{{Cmd|# apk add mesa-gles}} | |||
== 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]] | [[Category:Desktop Environments]] | ||
Latest revision as of 21:50, 28 November 2023
Prerequisites
- Install AlpineLinux
- Create a user account (optional but recommended)
- Enable the Community repository
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