alpine-wiki/documents/alpine-newbie-xfce-desktop.md
mckayshirou e7302a3c10 wiki structure mayor change: reestructuration in two mayor directories
* the documentation will handle the newbies section, simplification
* the professional documens will be merged with the new documents directories
* rest of informal or fast forward contributions will be in tutorials
2022-09-18 10:52:36 -04:00

707 lines
30 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Alpine XFCE4 desktop setup
===========================================================
This is a single only full article for first users,
targeted for mid-impatient that just want the way to see the desktoip in some hours:
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
If you want wayland crap: [.. use this guide named Fast Forward Wayland desktop](../tutorials/alpine-tutorial-desktop-wayland-try.md)
* [How to use this guide](#how-to-use-this-guide)
* [Installation of alpine](#installation-of-alpine)
* [Fast explanations, just 5 lines](#explanations)
* [how to install in single disc only](#how-to-install-in-single-disc-only)
* [preparation](#preparation-xfce4-aline)
* [instalation](#instalation)
* [setup OS configuration](#setup-os-configuration)
* [configuration programs and repositories](#configuration-programs-and-repositories)
* [setup system users](#setup-system-users)
* [setup hardware media support and graphical subsystem](#setup-hardware-media-support-and-graphical-subsystem)
* [setup software graphical fonts and languajes](#setup-software-graphical-fonts-and-languajes)
* [setup hardware media support and sound subsystem](#setup-hardware-media-support-and-sound-subsystem)
* [Instalacion XFCE4 Alpine](#instalacion-xfce4-apine)
* [Desktop multimedia and media devices](#desktop-multimedia-and-media-devices)
* [Desktop Office suite](#desktop-office-suite)
* [Development](#development)
* [base console development](#base-console-development)
* [base gui development](#base-gui-development)
* [Licensing clarifications](#licensing-clarifications)
* [See also](#see-also)
## How to use this guide
This guide **structure all the commands in blocks, each block its separated by a line spaced**,
so you must **tipe each line as is.. and hit enter**, but if you are in gui or remotelly just do:
1. copy each separated by empty line, block of command, copy only blocks separate by empty line
2. and paste each separated by empty line block in the remnote (ssh), do not paste all the blocks at same time!
**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 after finish, rerun: `sed -i -r 's|.*PermitRootLogin.*|PermitRootLogin no|g' /etc/ssh/sshd_config;service sshd restart`
**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.
## Installation of alpine
This guide will assume all the hard disk storage for the installation
otherwise check the best option at [alpine-newbie-install.md](alpine-newbie-install.md)
Ok but if you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
#### Explanations
Alpine is the OS (Operating System), that runs on your machine.
Programs such as a web browser runs on the OS, and web pages like
this are handled by the web browser.
About desktop? alpine is the Program combo that really runs in dockers,
becouse of that, the desktop part its not so targeted and focused..
Linux is just the kernel that handles and manages the hardware to the operating system
#### how to install in single disc only
* **1** download the image of the alpine ISO
* i386 older 32bit use : http://dl-cdn.alpinelinux.org/alpine/v3.12/releases/x86_64/alpine-extended-3.12.0_rc1-x86.iso
* amd64 newer 64bit use : http://dl-cdn.alpinelinux.org/alpine/v3.16/releases/x86_64/alpine-extended-3.16.0_rc1-x86_64.iso
* amrv7 64bit modern use : http://dl-cdn.alpinelinux.org/alpine/v3.16/releases/armv7/alpine-standard-3.16.0_rc1-armv7.iso
* **2** dump into usb stick.. check the process to do here: [alpine-newbie-how-to-dumb-easyle-with-gui-to-usb.md](alpine-newbie-how-to-dumb-easyle-with-gui-to-usb.md)
* **3** boot the usb stick from your computer.. this will depend of your vendor
* **4** after boot, just login.. using "root" word
* **5** type "setup-disk" and start to answer the first two questions, keyboard type and layout
* **6** Keyboard Layout (Local keyboard language and usage mode, e.g. us and variant of us-nodeadkeys.)
* **7** Hostname (The name for the computer.) Please here dont put symbols, and use a 8 chars only name.
* **8** Network (For example, automatic IP address discovery with the "DHCP" protocol.) for hoe just use "dhcp"
* **9** DNS Servers (Domain Name Servers to query. just use google's 8.8.8.8 .)
* **10** Timezone, becouse this is a single install just use UTC
* **11** Proxy (Use "none" for direct connections to the internet.)
* **12** Mirror (From where to download packages. Here put 1 and later we will tune up)
* **13** SSH (Secure SHell remote access server, mandatory, "Openssh" is part of the default install image)
* **14** NTP (Network Time Protocol client used for keeping the system clock in sync with a time server. "chrony")
* **15** Disk Mode here just select the sys mode, we are installing to use as desktop in single disc, so all the data will be wiped and erased.
If you must tune up we recommended to use virtual machine or check the best option at [alpine-newbie-install.md](alpine-newbie-install.md)
## preparation Xfce4 Alpine
To have a usable desktop without having to wonder why it doesn't sound,
or why the video file doesn't display, **you should avoid minimalisms if
you don't already have advanced knowledge** of alpine and even more so of linux.
#### Internet required or offile iso
If you dont have wired internet connection, check [lack of wireless setup](#lack-of-wireless-setup) section of this document.
**Or just please use our direct VenenuX Alpine ISOS**
[CURRENT LINK https://t.me/alpine_linux/762, but ask in telegram alpine network for newer one](https://t.me/s/alpine_linux/762)
#### setup OS configuration
1. deny access to the ssh root user, or well, get sure to deny such access
2. setup and start the ssh service, this always be present in Alpine installs
3. set the name of the computer, here we used `venenux-desktop`, please avoid symbols
4. hardcoded and set the network connection, to first wired network device
5. setup services of network to init at boot check [differences of hard coded setup](#differences-of-hard-coded-setup) section of this document
6. configure root account
7. create a remote connection limited account `daru`, check [the daru user explanation](#the-daru-user-explanation) section of this document
8. configure a default remote connection account `daru` as standard
```
sed -i -r 's|#PermitRootLogin.*|PermitRootLogin no|g' /etc/ssh/sshd_config
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 /root/.profile
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
set autologout = 6
set prompt = "$ "
set history = 0
set ignoreeof
EOF
cp /opt/daru/.cshrc /opt/daru/.bashrc
apk add 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
apk add testdisk testdisk-doc partimage partimage-doc parted parted-doc util-linux zram-init
```
Those command put your alpine in "non minimalist mode" so means
* manpages will be available, so you can check the operating system and gnu documetation
* commands will work exactly as another linxu or mac, google results of your doubs will work
* will reduce the environment of the system users and minimize the confortability of root account
* will provide all the system tools to the devices management
for more info of `daru`, check [the daru user explanation](#the-daru-user-explanation) section of this document
NExt section will cover the suser management and programs support:
#### configuration programs and repositories
1. Setup main and community repositories of sources of programs
2. update the local references of such repositories
3. install main command line utilities man page manager and easy to use editor
4. install string manipulation tools for the commands on the console
5. install file downloaders and url handlers for command line administration
6. install backend support for backend of archivers, will be need in any futher kind of install
7. setup the pager for large outputs over the console
8. install the support for languaje environment
``` bash
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 nano-doc binutils binutils-doc coreutils coreutils-doc readline readline-doc
apk add sed sed-doc attr attr-doc dialog dialog-doc lsof less less-doc groff groff-doc
apk add wget wget-doc curl curl-doc bash bash-doc bash-completion terminus-font
apk add zip p7zip xz tar cabextract cpio binutils lha acpi
export PAGER=less
apk add musl-locales musl-locales-lang
```
The packages that have a "-doc" part handles the manpages.. you can
avoid those packages, if Alpine usage will be for GUI only.
The packages of locales will be need as base for multi-lang enviroment.
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
#### setup system users
We will follow a protocol for better identification of all the commands
in further documents, the user will be called "general"; this is important
that it has does matter, what does not matter is for you cos you only "use".
The other important part here is the groups, user will not have porper access
to resources becouse the OS manages the access using levels by groups. Of course
all of this only works using the proper policy kit software.
1. install and setup advanced management of users and administration tool privilegies
2. setup the shell csh for all present users and future ones
3. setup the shell bash for all present users and future ones
4. setup the shell for skel directory, that will server as template
5. setup the Xresources configuration for skel directory, that will server as template
6. configure defaults for each new creation of new users with bash as default shell
7. configure the login environement for each user when login at the console
8. create the default new general usage user `general` for your desktop or console daily work
9. include this `general` user in the most used need groups to have proper access to resources
```
apk add shadow shadow-doc shadow-uidmap bash bash-doc bash-completion bash-dev doas doas-doc
cat > /tmp/tmpcs.tmp << EOF
set history = 10000
set prompt = "$ "
EOF
for i in $(ls /home);do cat /tmp/tmpcs.tmp > /home/$i/.cshrc;done
cat > /tmp/tmpbs.tmp << EOF
set prompt = "$ "
set history = 10000
if [ -f ~/.bash_aliases ]; then
. ~/.bash_aliases
fi
EOF
for i in $(ls /home);do cat /tmp/tmpbs.tmp > /home/$i/.bashrc;done
mkdir /etc/skel
cat /tmp/tmpcs.tmp > /etc/skel/.cshrc
cat /tmp/tmpbs.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
#MAIL_DIR /var/mail
#MAIL_FILE .mail
#FAILLOG_ENAB yes
LOG_OK_LOGINS no
SYSLOG_SU_ENAB yes
SYSLOG_SG_ENAB yes
SULOG_FILE /var/log/sulog
SU_NAME su
ENV_SUPATH PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
ENV_PATH PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
UMASK 022
UID_MIN 1000
UID_MAX 60000
SYS_UID_MIN 100
SYS_UID_MAX 999
GID_MIN 1000
GID_MAX 60000
SYS_GID_MIN 100
SYS_GID_MAX 999
LOGIN_RETRIES 3
LOGIN_TIMEOUT 60
CONSOLE_GROUPS floppy:audio:cdrom:users
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
```
In the last part the `general` user is created since for purposes of usage
the name its hard coded for the commands that can be sense and important,
because of the references in further documents.
At last, the groups are cofigured for the user, each one will define a
resource access, specially those for `disk`, `audio`, `video` and `netdev`.
#### setup hardware media support and graphical subsystem
Until this point, we have a user that can login to the system,
and bunch of programs to interact with the OS, but still do not
have any programs to make the computer or device work for us..
this target depends of the set of programs, this section will
configure the graphical environment to property setup any desktop.
1. install programs to manage devices dinamically by the OS and not admin user
2. setup service for dynamic device manager at boot, energy management and cpu frecuency management
3. install the graphical subsystem and modesetting multi GPU video card support
4. install the programs that manages the 3D backend for graphics
5. install set of need modules for basic GPU and dummy ones like virtual machines, avoid if not need.
6. install set of need modules for 2D/3D specific GPU or video card not so older generation supported
7. install set of need modules for 2D/3D common GPU or video card almost modern still supported
8. install support for multi resolution and keyboard language configuration over GUI programs
9. install the bus communitacion support, policy management and login backend and frontend
10. generate the machine id identification hack for stupid shistemd linux standards
11. activate the service of the bus cominucations, the policy rules and graphical login backend
12. start the service of the bus cominucations, the policy rules and graphical login backend
13. activate the service of the graphical frontend login manager
14. start the service of the graphical frontend login manager
15. install support for abstract device filesystem representation using FUSE user space
16. activate the service of abstract device filesystem representation using FUSE user space
17. install software backend for usage of abstract device filesystem representation using FUSE user space
```
apk add acpi eudev eudev-doc eudev-rule-generator eudev-openrc linux-firmware cpufreqd pciutils util-linux zram-init
rc-update add udev
rc-update add acpid
rc-update add cpufreqd
apk add xorg-server xorg-server-xnest xorg-server-xephyr xorg-server-doc xorg-server-doc xf86-video-dummy xf86-video-modesetting xf86-input-libinput
apk add mesa xinit mesa-dri-gallium mesa-osmesa mesa-egl mesa-gl mesa-gles freeglut glew glu
apk add xf86-video-vesa xf86-video-modesetting xf86-video-qxl xf86-video-vmware xf86-input-evdev xf86-input-synaptics
apk add xf86-video-r128 xf86-video-s3virge xf86-video-apm xf86-video-i128 xf86-video-glint xf86-video-tdfx xf86-video-openchrome
apk add xf86-video-intel xf86-video-amdgpu xf86-video-ati xf86-video-nouveau xf86-video-nv xf86-video-vesa
setup-devd udev
apk add libxinerama xrandr kbd setxkbmap xf86-input-evdev
apk add dbus dbus-x11 elogind elogind-openrc elogind-lang polkit polkit-openrc polkit-elogind lightdm lightdm-lang lightdm-gtk-greeter
dbus-uuidgen > /var/lib/dbus/machine-id
rc-update add dbus
rc-update add elogind
rc-update add polkit
rc-service dbus restart
rc-service elogind restart
rc-service polkit restart
rc-update add lightdm
rc-service lightdm restart
apk add fuse fuse-exfat-utils archivemount fuse-exfat avfs vte3 pcre2
rc-service fuse start
rc-update add fuse
apk add gvfs udisks2 udisks2-lang udisks2-doc gvfs-fuse gvfs-archive gvfs-dav gvfs-nfs gvfs-lang
```
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
#### setup software graphical fonts and languajes
Now we have support for graphics in the operating system,
but still do not have any graphical program, so we will prepare
minimal set of software for the right working of the programs
such like the fonts and the support of multi languajes.
1. install console support fonts for tty terminal and console terminal programs
2. setup and configure the default tty terminal fonts
3. set as service the configuration of the font at terminal
4. install basic set of default fonts for graphical programs, dejavu and bitstream ones
5. install fonts for japanese symbos and sans/comic like fonts
6. install fonts for cyrillic langs to display russian words
7. install fonts for mid-orient langs like arabic, hebrew, armenian, hindi / sanskrit
8. install fonts for langs like tailan and malayalam
9. install fonts for east-orient like chinese symbols,hangul and kana ones, includign japanese
```
apk add terminus-font
setfont /usr/share/consolefonts/ter-132n.psf.gz
sed -i "s#.*consolefont.*=.*#consolefont="ter-132n.psf.gz"#g" /etc/conf.d/consolefont
rc-update add consolefont boot
apk add ttf-dejavu font-bitstream-type1 font-bitstream-100dpi font-bitstream-75dpi font-adobe-utopia-type1 font-adobe-utopia-75dpi font-adobe-utopia-100dpi font-noto-georgian
apk add font-noto font-noto-extra font-noto-cjk font-noto-cjk-extra font-arabic-misc ttf-liberation ttf-linux-libertine
apk add font-misc-cyrillic font-mutt-misc font-screen-cyrillic font-winitzki-cyrillic font-cronyx-cyrillic
apk add font-noto-hebrew font-noto-arabic font-noto-armenian font-noto-cherokee font-noto-devanagari font-noto-ethiopic
apk add font-noto-lao font-noto-malayalam font-noto-tamil font-noto-thaana font-noto-thai
apk add font-noto-cjk font-noto-cjk-extra font-isas-misc
```
If you want to bypass and dont know anything, run steps from 1 to 4 adn then
after step 4 just install `font-noto-all` that provides support for all
langs symbols words.
#### setup hardware media support and sound subsystem
Audio support these days depends on video support, although it can still be
configured separately, nowadays it is strongly tied to video, that's why its
placed here this section, just below of the hardware video setup.
It should be noted that in Linux there is the system audio layer and the user audio layer,
formerly the first was and can used directly, nomadays, by using the second
we are in transition to the wonderful pipewire framework.
1. install the base audio subsystem software
2. install the base audio framework user support
3. restart bus communicacion, due we already have the software video subsystem support bus communication
4. setup the access prority for the audio communication
5. install optional bluetooth software support if you have a bluez audio card or phones
6. setup the bluetooth service
7. start the bluetooth service so the audio devices can be stablished
```
apk add alsa-utils alsa-utils-doc alsa-plugins alsa-plugins-doc alsa-tools alsa-tools-doc alsaconf
apk add pipewire pipewire-doc pipewire-pulse pipewire-alsa sndio sndio-doc
rc-service dbus restart
cat > /etc/security/limits.d/audio-limits.conf << EOF
@audio - memlock 256
@audio - nice -11
@audio - rtprio 88
EOF
apk add bluez bluez-openrc pipewire-spa-bluez
rc-update add bluetooth
rc-service bluetooth start
```
Now at this point we have audio and video configured, additionally we have
basic support for managing devices dynamically when connecting or disconnecting,
the only kind of devices not covered yet until this point are printers.
For any desktop this is the point where you choose which graphical environment
or desktop to install. Next section will prefers the XFCE4 desktop setup,
currently ws the first and its the most complete desktop packaged in the repos.
## instalacion Xfce4 Alpine
Since Alpine 3.13 the XFCE4 desktop its full modern, this means its pretty more heavy,
cos is build using GTK3 only.
On older or cheap devices, mostly for 32bit devices its better to use alpine 3.10 or 3.12
that uses GTK2 for almost all the programs.
1. install base desktop software packages
2. install base XFCE4 desktop packages, at this point, the system its ready for graphicall session
3. install and setup the login manager programs and policy manager software
4. setup the display login manager to start at boot
5. start the display manager, now you can use a minimal XFCE4 desktop, continue for complete experience
6. install cliboard manager, keyboard configurator, screensaver, screenshooter, and baterry manager
7. install packages for multi lang environment of the XFCE4 desktop if need, if login, logout and relogin
```
apk add gtk-update-icon-cache hicolor-icon-theme paper-gtk-theme adwaita-icon-theme mate-themes
apk add xfce4 xfce4-session xfce4-panel xfce4-terminal xarchiver mousepad network-manager-applet xfwm4-themes xfce-polkit xfce4-skel xfce4-power-manager xfce4-settings
apk add lightdm elogind elogind-openrc elogind-lang polkit polkit-openrc polkit-elogind lightdm lightdm-lang lightdm-gtk-greeter
rc-update add lightdm
rc-service lightdm restart
apk add xfce4-clipman-plugin xfce4-xkb-plugin xfce4-screensaver xfce4-screenshooter xfce4-taskmanager xfce4-whiskermenu-plugin xfce4-battery-plugin
apk add xfce4-panel-lang xfce4-clipman-plugin-lang xfce4-xkb-plugin-lang xfce4-screenshooter-lang xfce4-taskmanager-lang xfce4-whiskermenu-plugin-lang xfce4-battery-plugin-lang xfce4-power-manager-lang xfce4-settings-lang
```
The XFCE4 desktop is the most complete in Alpine, MATE and others have almost complete packages,
with minor fails or missing. The newers LXQT and CoreCube desktops are made in QT technology
so are more heavyweith for older devices, specially 32bit systems.
the LXDE desktop is not completed in alpine due the stupid mantainers policy of GTK3 targeted.
## Desktop multimedia and media devices
The media in linux its per se reduced, and in alpine so then more limited,
with this lines you will have all the need suported, for converting and playing,
and minimal support for editing.
1. install support for media management muti format over the programs
2. install support for sound and output of notifications over the programas
3. install support for media format reading and management backend (convertiion and reading)
4. install viewers for video and audio files
5. install management backend for media devices
6. install video resoulution flexibility and network backend support
7. install network frontend support and frontend management of network
8. install service task manager on boot
9. setup service of wifi backend management
10. setup general networking backend management service
11. setup all the users to property manage the audio, video and network devices
12. reconfigure the interfaces so the network gui can then manage it
13. start the network manager backend services, so the gui can manager then
14. at this point logout and relogin from your current sesion to start to work
```
apk add gst-plugins-base gst-plugins-bad gst-plugins-bad-lang gst-plugins-ugly gst-plugins-ugly-lang gst-plugins-good gst-plugins-good-gtk
apk add libcanberra-gtk2 libcanberra-gtk3 libcanberra-gstreamer wxgtk-media wxgtk3-media wxgtk-lang
apk add mediainfo ffmpeg ffmpeg-doc ffmpeg-libs lame lame-doc rtkit rtkit-doc
apk add mpv mpv-doc deadbeef deadbeef-lang deadbeef-doc
apk add gvfs gvfs-fuse gvfs-archive gvfs-afp gvfs-afp gvfs-afc gvfs-cdda gvfs-gphoto2 gvfs-mtp pcmanfm
apk add libxinerama xrandr wpa_supplicant dhcpcd chrony macchanger wireless-tools iputils
apk add network-manager-applet network-manager-applet-lang networkmanager networkmanager-lang networkmanager-elogind networkmanager-elogind-lang networkmanager-elogind-openrc networkmanager-openvpn networkmanager-openvpn-lang
rc-update add chrony
rc-update add wpa_supplicant
rc-update add networkmanager
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
```
## Desktop Office suite
In linux world there's no mayor suite or programs in such topic,
just we need a reader (pdf, ebooks, cbr, zbr, etc) and office
suite for word/calc processing (doc, xls, odt, ods, etc).
```
apk add libreoffice libreoffice-gnome evince evince-lang evince-doc
```
The programs will appear in the Office menu category.
## development
This is only for those that dont want to download bunch of thing
when install some programs from sources. In any cae, modding and plugin hacks
will need this for minecraft or minetest hard hacker players.
The most important tool for development is the VCS: version control system.
The most usefull too for GUI development is the IDE: intregrated development environment
From this, there's the RAD, means Rapid Application Development and the
prefered way model for starting newbies..
#### base console development
1. install the minimal standard needs like make, cmake and gcc, pkg-config was superset by pkgconf
2. install set of tools to merge or compare files
3. install the most used version control service: git (GIT) VCS
4. install the second most used version control service optionally: subversion (SVN) VCS
5. install the so famous version control service: mercurial (HG) VCS
6. install session terminal handler, so can save terminal sessions
```
apk add pkgconf make cmake cmake-bash-completion gcc gcc-gdc gcc-go g++ gcc-objc gcc-doc
apk add patch patch-doc patchutils patchutils-doc diffutils diffutils-doc
apk add git git-bash-completion git-zsh-completion git-cvs git-svn github-cli git-diff-highlight git-doc
apk add subversion subversion-bash-completion subversion-zsh-completion subversion-yash-completion subversion-doc
apk add mercurial mercurial-bash-completion mercurial-zsh-completion mercurial-doc
apk add tmux screen
```
From this point you can work in console terminal all development task,
of course, each development will need specific need, but this ones installed
are always basic and mandatory (almost in all cases).
Next section, will cover some usefully artifact like an IDE (Intregrated Development Environment):
#### base gui development
The most compatible and all availabe IDE is geany, **this powerful tool
is very poorly valued, since like everything in linux it must be configured
according to your interest**, unlike other java or python craps that comes
already configured.
In such case **Geany is as close to the Unix spirit** it featured: overview,
htmlpreview, compile, diff, CVS, colorpicker, htmlpicker, tabletools, codecleanup,
and much more.
For terminal insteach of the usage of tmux or screen inside the already GUI,
we recommended the yet ready for similar purposes Terminator.
```
apk add 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 meld meld-lang
apk add terminator terminator-lang
```
##### differences of hard coded setup
Disk paths, Networks and WIFI in linux have two scopes, the system and the user,
alpine uses a scope that is overwritten and superset if others apps are installed,
like networkmanager or desktops is installed, therefore, the network configuration
we make is temporary, and we assumed then wired one cos is easy to setup.
##### lack of wireless setup
WIFI networks are a little more complicated, that's why a wired network is assumed,
if you don't have the possibility of having an internet network, simply use our
complete iso that already has everything, and there you can use the wifi directly
from the graphical desktop check [Internet required or offile iso](#internet-required-or-offile-iso) section.
##### the daru user explanation
The meaning of **"daru"** user is to **able to login to you from another computer by restrictions**..
so no one can login with other user.. daru have a restricted shell and restricted commands.
The **right way its to use SSH Key Pair, but that is so complicated for readers right now**,
so using a restricted user for connections its enought untill that point.
## 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](alpine-newbie-install.md)
* [Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)