mirror of
https://codeberg.org/alpine/alpine-wiki.git
synced 2023-08-25 13:53:16 +02:00
tutorials-commuinity openbox desktop using packages and xfce4 apps, with jgmenu as root menu
* there are full issues with openbox and GTK apps: * no applications at pcmanfm https://gitlab.alpinelinux.org/alpine/aports/-/issues/14183 * no full features of jgmenu https://gitlab.alpinelinux.org/alpine/aports/-/issues/14182 * error missing files in adduser https://gitlab.alpinelinux.org/alpine/aports/-/issues/14178
This commit is contained in:
mckaygerhard
parent
dadc105c75
commit
d2c7ef0073
@ -0,0 +1,444 @@
|
||||
# Alpine OPENBOX desktop setup: FF version
|
||||
===========================================================
|
||||
|
||||
Alpine must be previously installed. For a WAYLAND desktop check [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md).
|
||||
For XFCE4 check [alpine-tutorial-desktop-xfce4-fast-forward.md](alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
|
||||
* [How to use this guide](#how-to-use-this-guide)
|
||||
* [Preparation](#preparation-openbox-aline)
|
||||
* [setup OS configuration](#setup-os-configuration)
|
||||
* [setup system users](#setup-system-users)
|
||||
* [setup hardware support](#setup-hardware-support)
|
||||
* [setup audio and video](#setup-audio-and-video)
|
||||
* [Instalacion XFCE4 Alpine](#instalacion-openbox-apine)
|
||||
* [Desktop multimedia and media devices](#desktop-multimedia-and-media-devices)
|
||||
* [Development](#development)
|
||||
* [Licensing clarifications](#licensing-clarifications)
|
||||
* [See also](#see-also)
|
||||
|
||||
## preparation Xfce4 Alpine
|
||||
|
||||
**YOU MUST HAVE DIRECT WIRED INTERNET, if not ask for an ISO from VenenuX:** [https://t.me/alpine_linux/762](https://t.me/s/alpine_linux/762)
|
||||
|
||||
#### setup OS configuration
|
||||
|
||||
Feels lost here? check [How to use this guide](#how-to-use-this-guide) section of this document
|
||||
|
||||
|
||||
```
|
||||
sed -i -r 's|#PermitRootLogin.*|PermitRootLogin no|g' /etc/ssh/sshd_config
|
||||
|
||||
rc-service sshd restart;rc-update add sshd default
|
||||
|
||||
hostname venenux-desktop
|
||||
echo 'hostname="venenux-desktop"' > /etc/conf.d/hostname
|
||||
echo "venenux-desktop" > /etc/hostname
|
||||
|
||||
cat > /etc/hosts << EOF
|
||||
127.0.0.1 venenux-desktop localhost.localdomain localhost
|
||||
::1 localhost localhost.localdomain
|
||||
EOF
|
||||
|
||||
cat > /etc/network/interfaces << EOF
|
||||
auto lo
|
||||
iface lo inet loopback
|
||||
|
||||
auto eth0
|
||||
iface eth0 inet dhcp
|
||||
|
||||
iface eth0 inet6 dhcp
|
||||
pre-up echo 0 > /proc/sys/net/ipv6/conf/eth0/accept_ra
|
||||
EOF
|
||||
|
||||
rc-service networking restart;rc-update add networking boot
|
||||
|
||||
cat > /root/.cshrc << EOF
|
||||
unsetenv DISPLAY || true
|
||||
HISTCONTROL=ignoreboth
|
||||
EOF
|
||||
|
||||
cp /root/.cshrc /root/.bashrc
|
||||
|
||||
echo "root:toor" | chpasswd
|
||||
|
||||
apk add tcsh
|
||||
|
||||
add-shell '/bin/csh'
|
||||
|
||||
adduser -D -g "" -u 998 -h /opt/daru -s /bin/csh daru
|
||||
|
||||
echo "daru:daru" | chpasswd
|
||||
|
||||
rm -f /opt/daru/*
|
||||
mkdir /opt/daru
|
||||
cat > /opt/daru/.cshrc << EOF
|
||||
unsetenv DISPLAY
|
||||
export PAGER=less
|
||||
set autologout = 6
|
||||
set prompt = "$ "
|
||||
set history = 0
|
||||
set ignoreeof
|
||||
EOF
|
||||
cp /opt/daru/.cshrc /opt/daru/.bashrc
|
||||
chown -R daru:daru /opt/daru
|
||||
|
||||
cat > /etc/apk/repositories << EOF
|
||||
http://dl-4.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/main
|
||||
http://dl-4.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/community
|
||||
EOF
|
||||
|
||||
apk update
|
||||
|
||||
apk add man-db man-pages nano binutils coreutils readline \
|
||||
sed attr dialog lsof less groff wget curl terminus-font \
|
||||
zip p7zip xz tar cabextract cpio binutils lha acpi musl-locales musl-locales-lang \
|
||||
e2fsprogs e2fsprogs-doc btrfs-progs btrfs-progs-doc exfat-utils exfat-utils-doc \
|
||||
f2fs-tools f2fs-tools-doc dosfstools dosfstools-doc xfsprogs xfsprogs-doc jfsutils jfsutils-doc \
|
||||
testdisk testdisk-doc partimage partimage-doc parted parted-doc util-linux zram-init
|
||||
|
||||
sed -i "s#.*consolefont.*=.*#consolefont="ter-132n.psf.gz"#g" /etc/conf.d/consolefont
|
||||
setfont /usr/share/consolefonts/ter-132n.psf.gz
|
||||
|
||||
rc-update add consolefont boot
|
||||
```
|
||||
|
||||
For more extended info check [../../newbie/alpine-newbie-xfce-desktop.md](../../newbie/alpine-newbie-xfce-desktop.md#setup-os-configuration)
|
||||
|
||||
#### setup system users
|
||||
|
||||
```
|
||||
apk add shadow shadow-uidmap doas musl-locales musl-locales-lang
|
||||
|
||||
cat > /tmp/tmp.tmp << EOF
|
||||
set history = 10000
|
||||
set prompt = "$ "
|
||||
EOF
|
||||
|
||||
mkdir /etc/skel
|
||||
cat /tmp/tmp.tmp > /etc/skel/.cshrc
|
||||
cat /tmp/tmp.tmp > /etc/skel/.bashrc
|
||||
|
||||
cat > /etc/skel/.Xresources << EOF
|
||||
Xft.antialias: 0
|
||||
Xft.rgba: rgb
|
||||
Xft.autohint: 0
|
||||
Xft.hinting: 1
|
||||
Xft.hintstyle: hintslight
|
||||
EOF
|
||||
|
||||
cat > /etc/default/useradd << EOF
|
||||
# useradd defaults file
|
||||
HOME=/home
|
||||
INACTIVE=-1
|
||||
EXPIRE=
|
||||
SHELL=/bin/bash
|
||||
SKEL=/etc/skel
|
||||
CREATE_MAIL_SPOOL=yes
|
||||
EOF
|
||||
|
||||
cat > /etc/login.defs << EOF
|
||||
USERGROUPS_ENAB yes
|
||||
SYSLOG_SU_ENAB yes
|
||||
SYSLOG_SG_ENAB yes
|
||||
SULOG_FILE /var/log/sulog
|
||||
SU_NAME su
|
||||
EOF
|
||||
|
||||
useradd -m -U -c "" -G wheel,input,disk,floppy,cdrom,dialout,audio,video,lp,netdev,games,users,ping general
|
||||
|
||||
for u in $(ls /home); do for g in disk lp floppy audio cdrom dialout video lp netdev games users ping; do addgroup $u $g; done;done
|
||||
```
|
||||
|
||||
**WARNING** your user name must be `general`, you can put a "human name" as you wish, later.
|
||||
|
||||
For more details check [../../newbie/alpine-newbie-xfce-desktop.md](../../newbie/alpine-newbie-xfce-desktop.md#setup-system-users)
|
||||
|
||||
#### setup hardware support
|
||||
|
||||
```
|
||||
apk add acpi eudev eudev-doc eudev-rule-generator eudev-openrc pciutils util-linux zram-init \
|
||||
fuse fuse-exfat-utils fuse-exfat avfs pcre2 cpufreqd bluez bluez-openrc \
|
||||
wpa_supplicant dhcpcd chrony macchanger wireless-tools iputils linux-firmware \
|
||||
networkmanager networkmanager-lang networkmanager-openvpn networkmanager-openvpn-lang
|
||||
|
||||
rc-update add udev
|
||||
rc-update add acpid
|
||||
rc-update add cpufreqd
|
||||
rc-update add fuse
|
||||
rc-update add bluetooth
|
||||
rc-update add chrony
|
||||
rc-update add wpa_supplicant
|
||||
rc-update add networkmanager
|
||||
|
||||
rc-service networking restart
|
||||
|
||||
rc-service wpa_supplicant restart
|
||||
|
||||
rc-service bluetooth restart
|
||||
|
||||
rc-service udev restart
|
||||
|
||||
rc-service fuse restart
|
||||
|
||||
rc-service cpufreqd restart
|
||||
|
||||
```
|
||||
|
||||
For more details check [../../newbie/alpine-newbie-xfce-desktop.md](../../newbie/alpine-newbie-xfce-desktop.md#setup-software-graphical-fonts-and-languajes)
|
||||
|
||||
#### setup audio and video
|
||||
|
||||
```
|
||||
apk add xorg-server xorg-server-xnest xorg-server-xnest xorg-server-doc xf86-input-evdev libxinerama xrandr kbd setxkbmap \
|
||||
mesa xinit mesa-dri-gallium xf86-video-dummy xf86-video-modesetting xf86-video-vesa xf86-input-libinput
|
||||
|
||||
apk add libxinerama xrandr kbd setxkbmap bluez bluez-openrc \
|
||||
dbus dbus-x11 elogind elogind-openrc lightdm lightdm-lang lightdm-gtk-greeter \
|
||||
polkit polkit-openrc polkit-elogind udisks2 udisks2-lang \
|
||||
gvfs gvfs-fuse gvfs-archive gvfs-dav gvfs-nfs gvfs-lang \
|
||||
networkmanager-elogind
|
||||
|
||||
dbus-uuidgen > /var/lib/dbus/machine-id
|
||||
|
||||
rc-update add dbus
|
||||
rc-update add elogind
|
||||
rc-update add polkit
|
||||
rc-update add lightdm
|
||||
|
||||
apk add font-noto-all ttf-dejavu ttf-linux-libertine ttf-liberation \
|
||||
font-bitstream-type1 font-bitstream-100dpi font-bitstream-75dpi \
|
||||
font-adobe-utopia-type1 font-adobe-utopia-75dpi font-adobe-utopia-100dpi \
|
||||
font-isas-misc
|
||||
|
||||
apk add alsa-utils alsa-plugins alsa-tools alsaconf \
|
||||
pipewire pipewire-pulse pipewire-alsa pipewire-spa-bluez
|
||||
|
||||
cat > /etc/security/limits.d/audio-limits.conf << EOF
|
||||
@audio - memlock 256
|
||||
@audio - nice -11
|
||||
@audio - rtprio 88
|
||||
EOF
|
||||
|
||||
rc-service dbus restart
|
||||
|
||||
rc-service elogind restart
|
||||
|
||||
rc-service polkit restart
|
||||
|
||||
rc-service lightdm restart
|
||||
|
||||
```
|
||||
|
||||
**WARNING** your user name must be `general`, you can put a "human name" as you wish, later.
|
||||
**HINT** check for some xf86-video packages like `xf86-video-intel`, `xf86-video-amdgpu`, `xf86-video-noveau`, `xf86-video-ati` or `xf86-video-nv`
|
||||
|
||||
## instalacion Xfce4 Alpine
|
||||
|
||||
Since Alpine 3.13 the XFCE4 desktop its GTK3 for 32bit devices its better to use alpine 3.10
|
||||
or 3.12 that uses GTK2 for almost all the programs.
|
||||
|
||||
```
|
||||
apk add gtk-update-icon-cache hicolor-icon-theme paper-gtk-theme adwaita-icon-theme
|
||||
|
||||
apk add numix-icon-theme numix-themes numix-themes-gtk2 numix-themes-gtk3 numix-themes-metacity numix-themes-openbox numix-themes-xfce4-notifyd numix-themes-xfwm4
|
||||
|
||||
apk add openbox openbox-doc jgmenu jgmenu-doc pcmanfm lxsession xfce4-terminal xarchiver mousepad \
|
||||
xfce4-panel xfwm4-themes xfce-polkit xfce4-skel xfce4-power-manager xfce4-settings \
|
||||
xfce4-clipman-plugin xfce4-xkb-plugin xfce4-screensaver xfce4-screenshooter xfce4-taskmanager \
|
||||
xfce4-panel-lang xfce4-clipman-plugin-lang xfce4-xkb-plugin-lang xfce4-screenshooter-lang \
|
||||
xfce4-taskmanager-lang xfce4-battery-plugin-lang xfce4-power-manager-lang xfce4-settings-lang \
|
||||
gvfs gvfs-fuse gvfs-archive gvfs-afp gvfs-afp gvfs-afc gvfs-cdda gvfs-gphoto2 gvfs-mtp \
|
||||
network-manager-applet network-manager-applet-lang vte3 \
|
||||
libreoffice libreoffice-gnome evince evince-lang evince-doc
|
||||
|
||||
rc-service networking restart
|
||||
|
||||
rc-service wpa_supplicant restart
|
||||
|
||||
rc-service networkmanager restart
|
||||
|
||||
rc-service lightdm restart
|
||||
|
||||
```
|
||||
|
||||
#### openbox session menu and desktop configure
|
||||
|
||||
**WARNING** the `openbox-doc` package must be installed
|
||||
|
||||
```
|
||||
cat > /etc/xdg/openbox/menu.xml << EOF
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<openbox_menu xmlns="http://openbox.org" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://openbox.org/ file:///usr/share/openbox/menu.xsd">
|
||||
|
||||
<menu id="root-menu" label="Openbox 3">
|
||||
<item label="Terminal">
|
||||
<action name="Execute"><execute>xfce4-terminal</execute></action>
|
||||
</item>
|
||||
<item label="Applicacions">
|
||||
<action name="Execute"><execute>jgmenu-run</execute></action>
|
||||
</item>
|
||||
<separator />
|
||||
<item label="Configure">
|
||||
<action name="Execute"><execute>xfce4-settings-manager</execute></action>
|
||||
</item>
|
||||
<item label="Reload">
|
||||
<action name="Reconfigure" />
|
||||
</item>
|
||||
<item label="Restart">
|
||||
<action name="Restart" />
|
||||
</item>
|
||||
<separator />
|
||||
<item label="Exit">
|
||||
<action name="Exit" />
|
||||
</item>
|
||||
</menu>
|
||||
</openbox_menu>
|
||||
EOF
|
||||
|
||||
mkdir -p /etc/skel/.config/jgmenu/
|
||||
cat > /etc/skel/.config/jgmenu/jgmenurc << EOF
|
||||
stay_alive = 0
|
||||
tint2_look = 0
|
||||
position_mode = pointer
|
||||
terminal_exec = xfce4-terminal
|
||||
terminal_args = -e
|
||||
menu_width = 200
|
||||
menu_padding_top = 5
|
||||
menu_padding_right = 1
|
||||
menu_padding_bottom = 4
|
||||
menu_padding_left = 1
|
||||
menu_radius = 0
|
||||
menu_border = 1
|
||||
menu_halign = left
|
||||
sub_hover_action = 1
|
||||
item_margin_y = 2
|
||||
item_height = 20
|
||||
item_padding_x = 4
|
||||
item_radius = 0
|
||||
item_border = 0
|
||||
sep_height = 3
|
||||
font = Sans 10
|
||||
icon_size = 16
|
||||
EOF
|
||||
|
||||
for u in $(ls /home); do mkdir -p /home/$u/.config/jgmenu && cp /etc/skel/.config/jgmenu/jgmenurc /home/$u/.config/jgmenu/jgmenurc; done
|
||||
|
||||
sed -i -r 's|.*xfce-mcs-manager \&.*|xfce-mcs-manager \&|g' /etc/xdg/openbox/autostart
|
||||
|
||||
sed -i -r 's|.*titleLayout.*|<titleLayout>NDLSIMC</titleLayout>|g' /etc/xdg/openbox/rc.xml
|
||||
sed -i -r 's|.*keepBorder.*|<keepBorder>yes</keepBorder>|g' /etc/xdg/openbox/rc.xml
|
||||
sed -i -r 's|.*animateIconify.*|<animateIconify>no</animateIconify>|g' /etc/xdg/openbox/rc.xml
|
||||
sed -i -r 's|[1-9]</size>|14</size>|g' /etc/xdg/openbox/rc.xml
|
||||
sed -i -r 's|[1-9]</number>|1</number>|g' /etc/xdg/openbox/rc.xml
|
||||
sed -i -r 's|.*drawContents.*|<drawContents>no</drawContents>|g' /etc/xdg/openbox/rc.xml
|
||||
sed -i -r 's|<command>kfmclient.*|<command>pcmanfm</command>|g' /etc/xdg/openbox/rc.xml
|
||||
sed -i -r 's|Clearlooks|Bear2|g' /etc/xdg/openbox/rc.mxl
|
||||
sed -i -r 's|.*root-menu.*|<action name="Execute"><command>jgmenu_run</command></action>|g' /etc/xdg/openbox/rc.xml
|
||||
|
||||
for u in $(ls /home); do mkdir -p /home/$u/.config/openbox; done
|
||||
```
|
||||
|
||||
#### desktop integration and device media
|
||||
|
||||
```
|
||||
apk add xdg-desktop-portal xdg-desktop-portal-wlr xdg-desktop-portal-lang xdg-desktop-portal-gtk xdg-desktop-portal-gtk-lang
|
||||
```
|
||||
|
||||
|
||||
#### Desktop multimedia and media devices
|
||||
|
||||
```
|
||||
apk add gst-plugins-base gst-plugins-bad gst-plugins-ugly gst-plugins-good gst-plugins-good-gtk \
|
||||
libcanberra-gtk2 libcanberra-gtk3 libcanberra-gstreamer wxgtk-media wxgtk3-media wxgtk-lang \
|
||||
mediainfo ffmpeg ffmpeg-doc ffmpeg-libs lame lame-doc rtkit rtkit-doc \
|
||||
mpv mpv-doc deadbeef deadbeef-lang libxinerama xrandr
|
||||
|
||||
for u in $(ls /home); do for g in plugdev audio cdrom dialout video netdev; do addgroup $u $g; done;done
|
||||
|
||||
cat > /etc/network/interfaces << EOF
|
||||
auto lo
|
||||
iface lo inet loopback
|
||||
EOF
|
||||
|
||||
service networking restart
|
||||
|
||||
service wpa_supplicant restart
|
||||
|
||||
service networkmanager restart
|
||||
|
||||
```
|
||||
|
||||
#### development
|
||||
|
||||
```
|
||||
apk add pkgconf make cmake gcc gcc-gdc gcc-go g++ gcc-objc gcc-doc \
|
||||
patch patch-doc patchutils patchutils-doc diffutils diffutils-doc \
|
||||
git git-cvs git-svn github-cli git-diff-highlight git-doc \
|
||||
subversion subversion-doc mercurial mercurial-doc \
|
||||
geany geany-plugins-lang geany-plugins-addons geany-plugins-geanyextrasel \
|
||||
geany-plugins-overview geany-plugins-geanyvc geany-plugins-treebrowser \
|
||||
geany-plugins-tableconvert geany-plugins-spellcheck geany-plugins-shiftcolumn \
|
||||
geany-plugins-utils geany-lang \
|
||||
terminator terminator-lang tmux screen meld meld-lang
|
||||
```
|
||||
|
||||
## How to use this guide
|
||||
|
||||
This guide **structure all the commands in blocks, each block its separated by a line spaced**,
|
||||
so you must **type each line as is.. and hit enter**, so you noted that then you
|
||||
typed each separated clocks of commands, copy/type only blocks separated by an empty line,
|
||||
all new(next) lines are made by just enter. the terminal will detect if must execute or not.
|
||||
|
||||
**If you have another computer or gui**, try to use SSH client like putty or just in terminal (MAC or Linux) do:
|
||||
|
||||
1. at the Alpine installation: `sed -i 's|.*PermitRootLogin.*|PermitRootLogin yes|g' /etc/ssh/sshd_config;service sshd restart`
|
||||
2. at the other OS just connect: `ssh -l root <ip>` change "`<ip>`" with the address of your device.
|
||||
3. copy each separated by empty line, block of command, copy only blocks separate by empty line
|
||||
4. and paste each separated by empty line block in the remnote (ssh), do not paste all the blocks at same time!
|
||||
|
||||
**CAUTION** Some Linux or/and Mac terminals have security cut/paste locks, so
|
||||
if you paste, the first line will be preceded by garbage, check always the first char of your paste.
|
||||
|
||||
**WARNING** after finish, rerun: `sed -i -r 's|.*PermitRootLogin.*|PermitRootLogin no|g' /etc/ssh/sshd_config`
|
||||
and restart ssh `service sshd restart` becouse security implications.
|
||||
|
||||
#### hardware used
|
||||
|
||||
| item | minimal feature | Extra recommendations |
|
||||
| ---------------- | ----------------- | ---------------------------------- |
|
||||
| RAM MB | 1Gb DDR1 | 6Gb DDR3, web browsers consumes so much |
|
||||
| CPU | intel Dual Core | Not necesary |
|
||||
| RAM CPU | 2Mb (L2) 4kb/L1 | |
|
||||
| GPU | intel G41 | Radeon X1200 For web browsers and modern apps will be need |
|
||||
| RAM GPU | 256Mb | 1Gb For web browsers and modern apps will be need |
|
||||
| Storage | 120Gb HDD WD | 256Gb SSD are mandatory for speed |
|
||||
| ARCH | 32bits (i386/arm6)| 64bits (amd64) mandatory for most modern apps unfortunatelly |
|
||||
| Audio | AC 97 | HD audio and HDMI audio are a mess |
|
||||
|
||||
#### usernames
|
||||
|
||||
| item | name | password |
|
||||
| --------- | ------------------- | -------- |
|
||||
| remote | daru | daru |
|
||||
| admin | root | toor |
|
||||
| user | general | general |
|
||||
|
||||
|
||||
## Licensing clarifications
|
||||
|
||||
**CC BY-NC-SA**: the project allows reusers to distribute, remix, adapt, and build upon the material
|
||||
in any medium or format for noncommercial purposes only, and only so long as attribution is given
|
||||
to the creators involved. If you remix, adapt, or build upon the material, you must license the modified
|
||||
material under identical terms, includes the following elements:
|
||||
|
||||
* **BY** – Credit must be given to the creator of each content respectivelly, starting at the first contributor.
|
||||
* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here!
|
||||
* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it.
|
||||
|
||||
https://codeberg.org/alpine/alpine-wiki/src/branch/main#license
|
||||
|
||||
## See also
|
||||
|
||||
* [README.md](README.md)
|
||||
* [alpine-newbie-install.md](../../newbie/alpine-newbie-install.md)
|
||||
* [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md)
|
||||
Loading…
Reference in New Issue
Block a user