updated README for 2024

README.md

@@ -13,13 +13,17 @@ Disable secure boot and fn-lock in bios (so that F-keys work as F-keys by defaul
 
 ## Installing Alpine
 
-Follow https://wiki.alpinelinux.org/wiki/Installation
+Put alpine standard image on Ventoy USB, load it from Ventoy in GRUB mode.
 
-Note that you will need to use Rufus; Ventoy does not work on this laptop (hangs after choosing the image).
+Follow https://wiki.alpinelinux.org/wiki/Installation
 
 ## Postinstall
 
-In `/etc/apk/repositories`, comment out 3.16, uncomment edge (main, community, testing),
+```
+doas apk add nano
+```
+
+In `/etc/apk/repositories`, comment out the version you installed, add edge (main, community, testing),
 since some of the packages we're going to install (river, element-desktop)
 only exist in testing.
 
@@ -29,29 +33,43 @@ doas apk update
 doas apk upgrade
 ```
 
+(note that this might break GRUB: https://wiki.alpinelinux.org/wiki/Release_Notes_for_Alpine_3.20.0)
+
 ## Usable editor by default (not vi)
 
 ```
 doas apk add micro
+doas apk del nano
 echo "export EDITOR=micro" >>.profile
-echo "permit setenv { EDITOR=\$EDITOR } nopass :wheel as root" | tee -a /etc/doas.d/doas.conf
+echo "permit setenv { EDITOR=\$EDITOR } :wheel" | tee -a /etc/doas.d/doas.conf
+```
+
+## Login manager (needed for desktop)
+
 ```
+doas apk add elogind polkit-elogind
+doas rc-update add elogind
+doas rc-update add polkit
+doas apk add greetd greetd-agreety
+doas rc-update add greetd
+```
+
+Also: edit `/etc/inittab` and comment out line enabling `getty` on `tty1`,
+otherwise both `agreety` and `getty` will run simultaneously, preventing login on `tty1`.
+(_TODO: Find links._)
+
+Reboot.
+
+Make sure that everything works: log in on `tty1`, check that e.g. `XDG_RUNTIME_DIR` is set in `env`.
 
 ## Installing river
 
 ```
-doas apk add eudev
-doas setup-udev
-doas apk add mesa-dri-gallium mesa-va-gallium
-doas apk add river river-doc mandoc
+doas apk add river river-doc
 doas apk add adwaita-icon-theme foot ttf-dejavu
-doas rc-update add seatd
-doas rc-service seatd start
-doas addgroup YOURUSER audio
-doas addgroup YOURUSER input
-doas addgroup YOURUSER seat
-doas addgroup YOURUSER video
-doas addgroup YOURUSER wheel
+doas setup-devd udev
+doas apk add mesa-dri-gallium mesa-va-gallium
+doas apk add 
 install -Dm0755 /usr/share/doc/river/examples/init -t ~/.config/river
 ```
 
@@ -59,11 +77,17 @@ Also:
 ```
 doas apk add xwayland
 ```
-because the latest river in testing is built in a way that requires xwayland.
+because the latest river in testing is built in a way that requires xwayland
+(see also: https://github.com/riverwm/river/issues/913).
 
 Try to run with
 ```
-XDG_RUNTIME_DIR=/tmp river
+river
+```
+
+or
+```
+dbus-run-session -- river
 ```
 
 You should see the blue screen of river. Try to open terminal with Win+Shift+Enter. Try to exit with Win+Shift+E.
@@ -167,25 +191,8 @@ If it looks decent: change consolefont in `/etc/conf.d/consolefont` to `"ter-132
 
 In order to not have to create wrapper scripts for all apps:
 
-Create `/usr/local/bin/inga-river` (and later `chmod +x /usr/local/bin/inga-river`) with the following (found in google):
-
-```
-#!/bin/sh
-
-export GDK_BACKEND=wayland,x11
-export MOZ_ENABLE_WAYLAND=1
-export CLUTTER_BACKEND=wayland
-export QT_QPA_PLATFORM=wayland-egl
-export ECORE_EVAS_ENGINE=wayland-egl
-export ELM_ENGINE=wayland_egl
-export SDL_VIDEODRIVER=wayland
-export _JAVA_AWT_WM_NONREPARENTING=1
-export NO_AT_BRIDGE=1
-export BEMENU_BACKEND=wayland
-
-river $@
-```
-
+Create `/usr/local/bin/inga-river` (and later `chmod +x /usr/local/bin/inga-river`) with the [following content](global/usr/local/bin/inga-river).
+ 
 and replace `river` with `inga-river` in `/etc/greetd/environments`.
 
 ### Keyring