From 310d52e2a4d05b25a61908b6ead2f467693624bc Mon Sep 17 00:00:00 2001 From: Inga Date: Thu, 8 Feb 2024 20:47:11 +0100 Subject: [PATCH] updated README for 2024 --- README.md | 79 ++++++++++++++++++++++++++++++------------------------- 1 file changed, 43 insertions(+), 36 deletions(-) diff --git a/README.md b/README.md index 605710c..a7d7e76 100644 --- a/README.md +++ b/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