Installing GNOME

First, start desktop installer

  ~ $ setup-desktop

and enter your username, full name and setup password

  Setup a user? (enter a lower-case loginname, or 'no') [no] rifu
Full name for user rifu [rifu] Rifu Nihon

Input gnome desktop environment when prompted

  Which desktop environment? ('gnome', ... or 'none') [none] gnome

Setup user

Add yourself to plugdev to manage connections without root access and wheel to gain root access using doas

  usermod -aG plugdev rifu
usermod -aG wheel rifu

Install doas itself

  apk add doas

Now it’s time to configure doas. To open configuration file, enter:

  vi /etc/doas.conf

and then hit i on the keyboard.

Uncomment the line with :wheel here

  # See doas.conf(5) and doas.d(5) for configuration details.
# Configuration here may be overridden by /etc/doas.d/*.conf if files exist.

# Uncomment to allow group "wheel" to become root.
permit persist :wheel

To save file, press ESC then write :wq and hit Enter.

Setup NetworkManager

Install necessary packages for Bluetooth and Wi-Fi

  apk add networkmanager-wifi networkmanager-bluetooth networkmanager-dnsmasq bluez

Enable Bluetooth

  rc-update add bluetooth default

Enable NetworkManager

  rc-update add networkmanager

Configure

  vi /etc/NetworkManager/NetworkManager.conf

reproduce these settings

  [main] 
dhcp=internal
plugins=ifupdown,keyfile

[ifupdown]
managed=true

[device]
wifi.scan-rand-mac-address=yes
wifi.backend=wpa_supplicant

More locales support

Add ICU & musl with non-English locales too

  apk add icu-data-full musl-locales

Add firmware & drivers

To have better software compatibility, you should install:

  apk add linux-firmware mesa-va-gallium

If you have Intel GPU (since Intel Broadwell) also install

  apk add intel-media-driver

Remember brightness

Every boot you may notice that the brightness isn’t saving after changing it on your device in GNOME quick setting panel, so here is the fix.

First, install brightnessctl:

  apk add brightnessctl

Second, make it working from boot

  rc-update add brightnessctl boot

and now you can notice brightness change back to normal while booting.

Power profiles

Showcase

Installation

  apk add power-profiles-daemon

GNOME Software

For apk package management through the GNOME Software, run

  rc-update add apk-polkit-server

Fonts support

For Japanese support

  apk add font-terminus font-noto font-noto-thai font-noto-tibetan font-ipa font-sony-misc font-jis-misc

For other please refer to Alpine Wiki

Boot into GNOME

Finishing our setup. So let’s take a bite of it.

Reboot the system and see the result:

  reboot
Edit this page

Last updated 30 Mar 2025, 00:20 +03 . history