Alpine Linux - User contributions [en]

AwesomeWM

2022-02-24T18:55:07Z

Ethanpil: /* VMWare Users probably want to use this for video */

[[file: awesome-01.png |thumb |Screenshot]]
{{TOC right}}

= Prerequisites =
* [[Installation|Install]] Alpine Linux
* [https://wiki.alpinelinux.org/wiki/Post_installation#Creating_a_new_user_account Create a user account] (optional but recommended)
* Enable the [[Enable_Community_Repository|Community Repository]]

= Install packages =
Install awesome, xterm, lua and terminus font. 
Depending on your network speed, it might take a few minutes.
{{Cmd|# apk add awesome xterm lua terminus-font}}

== Optional packages ==
=== Video and Input packages ===
You might want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset, install 'xf86-video-sis'. For Intel video chipset, install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# apk add xf86-input-synaptics}}

Run 'apk search xf86-video*' to see available xf86-video packages. 
Run 'apk search xf86-input*' to see available xf86-input packages. 

===VirtualBox Users===
{{Cmd|# apk add xf86-video-vbox}}

===VMWare Users===
{{Cmd|# apk add xf86-video-vmware}}
and/or
{{Cmd|# apk add xf86-input-vmmouse}}

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory}}

If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:

Install dbus from apk (you must be logged in as root for the step shown below)
{{Cmd|# apk add dbus}}

Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched, it should load the desktop correctly

= See also =
* [[Installation]]
* [[Post installation]]
* [[Desktop environments and Window managers]]

[[Category:Desktop]]
[[Category:Lua]]

AwesomeWM

2022-02-24T18:54:55Z

Ethanpil:

[[file: awesome-01.png |thumb |Screenshot]]
{{TOC right}}

= Prerequisites =
* [[Installation|Install]] Alpine Linux
* [https://wiki.alpinelinux.org/wiki/Post_installation#Creating_a_new_user_account Create a user account] (optional but recommended)
* Enable the [[Enable_Community_Repository|Community Repository]]

= Install packages =
Install awesome, xterm, lua and terminus font. 
Depending on your network speed, it might take a few minutes.
{{Cmd|# apk add awesome xterm lua terminus-font}}

== Optional packages ==
=== Video and Input packages ===
You might want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset, install 'xf86-video-sis'. For Intel video chipset, install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# apk add xf86-input-synaptics}}

Run 'apk search xf86-video*' to see available xf86-video packages. 
Run 'apk search xf86-input*' to see available xf86-input packages. 

===VirtualBox Users===
{{Cmd|# apk add xf86-video-vbox}}

===VMWare Users probably want to use this for video===
{{Cmd|# apk add xf86-video-vmware}}
and/or
{{Cmd|# apk add xf86-input-vmmouse}}

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory}}

If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:

Install dbus from apk (you must be logged in as root for the step shown below)
{{Cmd|# apk add dbus}}

Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched, it should load the desktop correctly

= See also =
* [[Installation]]
* [[Post installation]]
* [[Desktop environments and Window managers]]

[[Category:Desktop]]
[[Category:Lua]]

AwesomeWM

2022-02-24T18:54:09Z

Ethanpil:

[[file: awesome-01.png |thumb |Screenshot]]
{{TOC right}}

= Prerequisites =
* [[Installation|Install]] Alpine Linux
* [https://wiki.alpinelinux.org/wiki/Post_installation#Creating_a_new_user_account Create a user account] (optional but recommended)
* Enable the [[Enable_Community_Repository|Community Repository]]

= Install packages =
Install awesome, xterm, lua and terminus font. 
Depending on your network speed, it might take a few minutes.
{{Cmd|# apk add awesome xterm lua terminus-font}}

== Optional packages ==
=== Video and Input packages ===
You might want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset, install 'xf86-video-sis'. For Intel video chipset, install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# apk add xf86-input-synaptics}}

VirtualBox Users
{{Cmd|# apk add xf86-video-vbox}}

VMWare Users probably want to use this for video
{{Cmd|# apk add xf86-video-vmware}}
and/or
{{Cmd|# apk add xf86-input-vmmouse}}

Run 'apk search xf86-video*' to see available xf86-video packages. 
Run 'apk search xf86-input*' to see available xf86-input packages. 

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory}}

If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:

Install dbus from apk (you must be logged in as root for the step shown below)
{{Cmd|# apk add dbus}}

Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched, it should load the desktop correctly

= See also =
* [[Installation]]
* [[Post installation]]
* [[Desktop environments and Window managers]]

[[Category:Desktop]]
[[Category:Lua]]

Fluxbox

2021-11-22T19:26:30Z

Ethanpil: /* Enable Community Repository */

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install fluxbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set fluxbox as the default WM =
{{Cmd|$ echo 'exec startfluxbox' >> ~/.xinitrc}}

= Start your X! =
{{Cmd|$ startx}}

'''Note:''' The default menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.

= Edit fluxbox settings =
You can now edit the flux settings for your user by editing the files located in
{{Cmd|~/.fluxbox/}}

This directory is created after your first run of fluxbox. The Fluxbox configuration details can he studied on the [http://fluxbox.org/help/ Fluxbox Help Page].

The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available on the [http://fluxbox.org/help/ Fluxbox Help Page].

Fluxbox

2021-11-22T19:26:16Z

Ethanpil: Created page with "= Initial setup = Start by booting Alpine (see these instructions on how to do that) = Enable Community Repository = We need the Community Repository ava..."

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install fluxbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set fluxbox as the default WM =
{{Cmd|$ echo 'exec startfluxbox' >> ~/.xinitrc}}

= Start your X! =
{{Cmd|$ startx}}

'''Note:''' The default menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.

= Edit fluxbox settings =
You can now edit the flux settings for your user by editing the files located in
{{Cmd|~/.fluxbox/}}

This directory is created after your first run of fluxbox. The Fluxbox configuration details can he studied on the [http://fluxbox.org/help/ Fluxbox Help Page].

The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available on the [http://fluxbox.org/help/ Fluxbox Help Page].

Openbox

2021-11-19T21:42:31Z

Ethanpil: /* Start your X! */

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install openbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set openbox as the default WM =
{{Cmd|$ echo 'openbox-session' >> ~/.xinitrc}}

= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}

'''Note:''' The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available in the [http://openbox.org/wiki/Help:Configuration OpenBox configuration documentation].

= Edit openbox settings =
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}

The OpenBox configuration details can he studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].

= Start your X! =
{{Cmd|$ startx}}

'''Note:''' The default OpenBox menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.

The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available in the [http://openbox.org/wiki/Help:Configuration OpenBox configuration documentation].

Openbox

2021-11-19T21:42:18Z

Ethanpil: /* Copy the config files to your home folder */

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install openbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set openbox as the default WM =
{{Cmd|$ echo 'openbox-session' >> ~/.xinitrc}}

= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}

'''Note:''' The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available in the [http://openbox.org/wiki/Help:Configuration OpenBox configuration documentation].

= Edit openbox settings =
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}

The OpenBox configuration details can he studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].

= Start your X! =
{{Cmd|$ startx}}

'''Note:''' The default OpenBox menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.

Openbox

2021-11-19T21:42:00Z

Ethanpil: /* Copy the config files to your home folder */

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install openbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set openbox as the default WM =
{{Cmd|$ echo 'openbox-session' >> ~/.xinitrc}}

= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}

Note: The default configuration is minimal and most menu options won't work unless you customize and/or install additional packages. More information is available in the [http://openbox.org/wiki/Help:Configuration OpenBox configuration documentation].

= Edit openbox settings =
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}

The OpenBox configuration details can he studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].

= Start your X! =
{{Cmd|$ startx}}

'''Note:''' The default OpenBox menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.

Openbox

2021-11-19T21:40:21Z

Ethanpil: /* Set openbox as the default WM */

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install openbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set openbox as the default WM =
{{Cmd|$ echo 'openbox-session' >> ~/.xinitrc}}

= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}

= Edit openbox settings =
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}

The OpenBox configuration details can he studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].

= Start your X! =
{{Cmd|$ startx}}

'''Note:''' The default OpenBox menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.

Openbox

2021-11-19T21:40:04Z

Ethanpil: /* Start your X! */

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install openbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set openbox as the default WM =
{{Cmd|$ echo 'openbox-session' >> /home/<newuser>/.xinitrc}}

= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}

= Edit openbox settings =
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}

The OpenBox configuration details can he studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].

= Start your X! =
{{Cmd|$ startx}}

'''Note:''' The default OpenBox menu (right click on desktop) will have a lot of options that won't work because we didnt install anything else! Luckily XTerm will work if you added the package in the first step, and you can use that to add additional packages.

Openbox

2021-11-19T21:38:13Z

Ethanpil: /* Install packages */

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install openbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

xterm is needed so you have a way to access the terminal in X. There are alternatives but this is the classic.
Terminus is needed because without any fonts, you will not be able to see any text in OpenBox.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set openbox as the default WM =
{{Cmd|$ echo 'openbox-session' >> /home/<newuser>/.xinitrc}}

= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}

= Edit openbox settings =
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}

The OpenBox configuration details can he studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].

= Start your X! =
{{Cmd|$ startx}}

Openbox

2021-11-18T02:36:02Z

Ethanpil: /* Install packages */

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install openbox, xterm, and terminus font. 

{{Cmd|# apk add openbox xterm terminus-font}}

Depending on your network speed, it might take a few minutes.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set openbox as the default WM =
{{Cmd|$ echo 'openbox-session' >> /home/<newuser>/.xinitrc}}

= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}

= Edit openbox settings =
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}

The OpenBox configuration details can he studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].

= Start your X! =
{{Cmd|$ startx}}

AwesomeWM

2021-11-18T01:31:04Z

Ethanpil:

[[file: awesome-01.png |thumb |Screenshot]]
{{TOC right}}

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the necessary packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install awesome, xterm, lua and terminus font. 
Depending on your network speed, it might take a few minutes.
{{Cmd|# apk add awesome xterm lua terminus-font}}

== Optional packages ==
=== Video and Input packages ===
You might want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset, install 'xf86-video-sis'. For Intel video chipset, install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# apk add xf86-input-synaptics}}

Run 'apk search xf86-video*' to see available xf86-video packages. 
Run 'apk search xf86-input*' to see available xf86-input packages. 

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

= Create user accounts =
Create a normal user account.
{{Cmd|# adduser <user>}}

Optionally, give that user sudo permissions in /etc/sudoers. When doing so, it is important to use the command: {{Cmd|# visudo}} This ensures that only one user is changing the file at any given time. Visudo has two modes: Command mode and Insert mode. To edit the file, use the arrows to navigate to the appropriate line and enter Insert mode by pressing the 'i' key. To save and exit, enter Command mode by pressing the 'Esc' key, then ':w' + 'enter' to save, and finally ':q' + 'enter' to quit.

Log out of the root account and log in to the newly created account.

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory}}

If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:

Install dbus from apk (you must be logged in as root for the step shown below)
{{Cmd|# apk add dbus}}

Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched, it should load the desktop correctly

= =
* [[Dwm]]

[[Category:Desktop]]
[[category: Lua]]

AwesomeWM

2021-11-18T01:30:45Z

Ethanpil: /* Enable Community Repository */

[[file: awesome-01.png |thumb |Screenshot]]
{{TOC right}}

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install awesome, xterm, lua and terminus font. 
Depending on your network speed, it might take a few minutes.
{{Cmd|# apk add awesome xterm lua terminus-font}}

== Optional packages ==
=== Video and Input packages ===
You might want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset, install 'xf86-video-sis'. For Intel video chipset, install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# apk add xf86-input-synaptics}}

Run 'apk search xf86-video*' to see available xf86-video packages. 
Run 'apk search xf86-input*' to see available xf86-input packages. 

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

= Create user accounts =
Create a normal user account.
{{Cmd|# adduser <user>}}

Optionally, give that user sudo permissions in /etc/sudoers. When doing so, it is important to use the command: {{Cmd|# visudo}} This ensures that only one user is changing the file at any given time. Visudo has two modes: Command mode and Insert mode. To edit the file, use the arrows to navigate to the appropriate line and enter Insert mode by pressing the 'i' key. To save and exit, enter Command mode by pressing the 'Esc' key, then ':w' + 'enter' to save, and finally ':q' + 'enter' to quit.

Log out of the root account and log in to the newly created account.

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory}}

If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:

Install dbus from apk (you must be logged in as root for the step shown below)
{{Cmd|# apk add dbus}}

Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched, it should load the desktop correctly

= =
* [[Dwm]]

[[Category:Desktop]]
[[category: Lua]]

Openbox

2021-11-18T01:30:10Z

Ethanpil: Updated and simplified

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages. Instructions are available on the [[Enable_Community_Repository|Enable Community Repository]] page.

= Install packages =
Install openbox, xterm, and terminus font. 

Depending on your network speed, it might take a few minutes.

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

== acpid ==
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Set openbox as the default WM =
{{Cmd|$ echo 'openbox-session' >> /home/<newuser>/.xinitrc}}

= Copy the config files to your home folder =
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/openbox ~/.config}}

= Edit openbox settings =
You can now edit the openbox settings for your user by editing the files located in
{{Cmd|~/.config/openbox}}

The OpenBox configuration details can he studied on the [http://openbox.org/wiki/Help:Contents#Configuration OpenBox wiki].

= Start your X! =
{{Cmd|$ startx}}

Enable Community Repository

2021-11-18T01:04:41Z

Ethanpil: /* Using community repositories */

Alpine software repositories have main packages and contributions made. Each Alpine release has two branches of repositories. The '''/community''' repository of each Alpine release contains community supported packages that were accepted from the '''/testing''' repository. Only '''/main''' repository of each version of Alpine release are supported for some Main Alpine Developers and Man Powers.

* '''Main packages''' are the Alpine package software that have direct support and updates from the Alpine core and main team, also have official documentation. Are always available for all releases and will have substitutions if some are not continued from upstream. Commonly those packages are selected due their responsibility and stability respecting upstream availability. Packages from ''testing'' that performs well or are mature goes to ''main'' branch.

* '''Community packages''' are those made by users in team with the official developers and well near integrated to the Alpine packages. Those have supported by those user contributions and could end if the user also ends respect with Alpine work, but may be removed in a future release due lack of support by upstream author. Packages from ''testing'' that are accept goes to ''community'' branch.

* '''Testing''' packages come into testing or edge repositories and are those made by any contributor on Alpine, the edge, this branch of repository has no release linked or related of Alpine. Those are in ''edge'' and when accepted goes to ''testing''.

For further information check [[Alpine_newbie#APK|Alpine newbie APK]] section wiki page.

== Using community repositories ==

The '''community''' repository was introduced with Alpine Linux version 3.3.

To enable the repository, edit the file {{Path|/etc/apk/repositories}} and add (or uncomment) a line that points to the "community" directory.

Its format is:

<code>'''https://<mirror-server>/alpine/<version>/community'''</code>

{{Tip|A usable editor is {{Pkg|nano}}, and it can be installed with <code>apk add nano</code>.}}

After enabling the community repository, one needs to update the index of available packages with:
{{Cmd|apk update}}
And then it's possible to install packages from the community repository.

=== Adding community repositories with a script ===

The following commands will add the main and community repositories for the Alpine version you're using. It will overwrite your existing repository settings.

{{cmd|cat > /etc/apk/repositories << EOF; $(echo)
<nowiki>
http://dl-cdn.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/main
http://dl-cdn.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/community
http://dl-cdn.alpinelinux.org/alpine/edge/testing
</nowiki>
EOF

}}

Dont forget to run this after:.
{{Cmd|apk update}}

== Using specific package versions ==

You can specify or pin "sticky" package versions like this:

* <code><nowiki>apk add packagename=1.2.3-suffix</nowiki></code>
* <code><nowiki>apk add 'packagename<1.2.3-suffix'</nowiki></code>

That will upgrade these packages only until the specified version.

It's then safe to use <code>apk upgrade</code> to upgrade all packages, while packages with versions will remain on the specified version.

To set a minimum version just add <code>…</code>.

{{Warning|Pinning a package to an exact version carries the risk that the package will be dropped from the repo, and at some time can't be downloaded anymore (e.g. during boot or Dockerfile build).

The official recommendation can be read here, citation below.
Alternately, you could simply set a minimum package version
instead of an exact version.

We don't at the moment have resources to store all built packages
indefinitely in our infrastructure. Thus we currently keep only
the latest for each stable branch.
}}

== Using testing repositories ==

The '''testing''' repository was introduced with Alpine Linux edge development. To enable the repository, edit the file {{Path|/etc/apk/repositories}} using an editor ({{Pkg|nano}} for instance) and add a line that points to the "testing" directory, formatted as in:

<code>'''https://<mirror-server>/alpine/edge/testing'''</code>

After enabling the testing repository, one needs to obtain the latest index of available packages with:
{{Cmd|apk update}}

Inexperienced users should not enable this.

=== Using packages from testing (edge) ===

Never pin packages from the "edge" branch of the alpine package repo, as these are in test and may be revoked. (At pkgs.alpinelinux.org/packages, click "edge" and change it to the alpine image version you use, and click "search" again.)

Inexperienced users should not enable this.

= See also =

* [[Alpine_newbie#APK|Alpine newbie APK]]

[[Category:Package Manager]]

Openbox

2021-11-18T00:54:31Z

Ethanpil:

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
We need the Community Repository available for access to the OpenBox packages.

Uncomment {{codeline|http://<url>/alpine/<version>/community}} in {{path|/etc/apk/repositories}}. For example:
{{cat|/etc/apk/repositories|<nowiki># /etc/apk/repositories

The following commands will add the main and community repositories for the version you're using to APK, as well as the edge/testing repository.

You can manually add them to the '''/etc/apk/repositories''' file if you prefer.

The command '''apk update''' should be run after updating the file in either method.

{{cmd|cat > /etc/apk/repositories << EOF; $(echo)
<nowiki>
http://dl-cdn.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/main
http://dl-cdn.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/community
http://dl-cdn.alpinelinux.org/alpine/edge/testing
</nowiki>
EOF

apk update}}

These following commands should set up Xorg with Openbox and some necessary packages.

{{cmd|setup-xorg-base openbox terminator slim dbus-x11 xf86-video-intel
xf86-video-ati xf86-video-amdgpu xf86-input-mouse xf86-input-keyboard setxkbmap

rc-update add dbus

rc-service dbus start

apk add fuse gvfs gvfs-mtp gvfs-lang gvfs-archive gvfs-fuse gvfs-gphoto2

rc-update add fuse

apk add faenza-icon-theme
}}

This will install lot of packages as gtk, cairo, python, perl, and some xorg modules for device user interaction.

{{cmd|setup-xorg-base xf86-video-intel xf86-video-ati xf86-video-amdgpu xf86-video-modesetting-0.9.0-r6
xf86-video-intel-2.99.917_git20170325-r0
xf86-video-amdgpu-doc-1.3.0-r0
xf86-video-sunleo-doc-1.2.2-r0
xf86-video-nouveau-doc-1.0.15-r0
xf86-video-vmware-doc-13.2.1-r0
xf86-video-dummy-0.3.8-r0
xf86-video-vesa-doc-2.3.4-r2
xf86-video-nv-doc-2.1.21-r0
xf86-video-nouveau-1.0.15-r0
xf86-video-siliconmotion-doc-1.7.9-r0
xf86-video-i740-1.3.6-r0
xf86-video-apm-doc-1.2.5-r8
xf86-video-savage-doc-2.3.9-r0
xf86-video-amdgpu-1.3.0-r0
xf86-video-s3virge-1.10.7-r1
xf86-video-openchrome-doc-0.6.0-r1
xf86-video-s3-doc-0.6.5-r8
xf86-video-ast-1.1.5-r1
xf86-video-apm-1.2.5-r8
xf86-video-s3-0.6.5-r8
xf86-video-fbdev-doc-0.4.4-r5
xf86-video-siliconmotion-1.7.9-r0
xf86-video-vmware-13.2.1-r0
xf86-video-r128-doc-6.10.2-r0
xf86-video-ati-doc-7.9.0-r0
xf86-video-sunleo-1.2.2-r0
xf86-video-fbdev-0.4.4-r5
xf86-video-dummy-doc-0.3.8-r0
xf86-video-rendition-doc-4.2.6-r1
xf86-video-ati-7.9.0-r0
xf86-video-rendition-4.2.6-r1
xf86-video-i128-1.3.6-r8
xf86-video-tdfx-doc-1.4.7-r0
xf86-video-glint-doc-1.2.9-r0
xf86-video-i740-doc-1.3.6-r0
xf86-video-tdfx-1.4.7-r0
xf86-video-chips-1.2.7-r0
xf86-video-chips-doc-1.2.7-r0
xf86-video-sis-0.10.9-r0
xf86-video-qxl-0.1.5-r0
xf86-video-intel-doc-2.99.917_git20170325-r0
xf86-video-vesa-2.3.4-r2
xf86-video-xgixp-1.8.1-r8
xf86-video-glint-1.2.9-r0
xf86-video-ast-doc-1.1.5-r1
xf86-video-ark-doc-0.7.5-r7
xf86-video-r128-6.10.2-r0
xf86-video-xgixp-doc-1.8.1-r8
xf86-video-sis-doc-0.10.9-r0
xf86-video-nv-2.1.21-r0
xf86-video-s3virge-doc-1.10.7-r1
xf86-video-openchrome-0.6.0-r1
xf86-video-ark-0.7.5-r7
xf86-video-savage-2.3.9-r0
xf86-video-i128-doc-1.3.6-r8

apk add xf86-input-mouse xf86-input-keyboard
}}

Talk:Openbox

2021-11-18T00:53:06Z

Ethanpil: Created page with "There is a lot of outdated info and complexity here. I will reduce the instructions to the minimum."

There is a lot of outdated info and complexity here. I will reduce the instructions to the minimum.

AwesomeWM

2021-11-18T00:44:57Z

Ethanpil: /* Install packages */

[[file: awesome-01.png |thumb |Screenshot]]
{{TOC right}}

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
In order to install the awesome package (see "Install packages" below), you need to enable the community repository for your version. Uncomment {{codeline|http://<url>/alpine/<version>/community}} in {{path|/etc/apk/repositories}}. For example:
{{cat|/etc/apk/repositories|<nowiki># /etc/apk/repositories

#/media/sdb/apks
http://mirror.csclub.uwaterloo.ca/alpine/v3.14/main
http://mirror.csclub.uwaterloo.ca/alpine/v3.14/community
#http://mirror.csclub.uwaterloo.ca/alpine/v3.14/testing
</nowiki>
}}

= Install packages =
Install awesome, xterm, lua and terminus font. 
Depending on your network speed, it might take a few minutes.
{{Cmd|# apk add awesome xterm lua terminus-font}}

== Optional packages ==
=== Video and Input packages ===
You might want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset, install 'xf86-video-sis'. For Intel video chipset, install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# apk add xf86-input-synaptics}}

Run 'apk search xf86-video*' to see available xf86-video packages. 
Run 'apk search xf86-input*' to see available xf86-input packages. 

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

= Create user accounts =
Create a normal user account.
{{Cmd|# adduser <user>}}

Optionally, give that user sudo permissions in /etc/sudoers. When doing so, it is important to use the command: {{Cmd|# visudo}} This ensures that only one user is changing the file at any given time. Visudo has two modes: Command mode and Insert mode. To edit the file, use the arrows to navigate to the appropriate line and enter Insert mode by pressing the 'i' key. To save and exit, enter Command mode by pressing the 'Esc' key, then ':w' + 'enter' to save, and finally ':q' + 'enter' to quit.

Log out of the root account and log in to the newly created account.

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory}}

If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:

Install dbus from apk (you must be logged in as root for the step shown below)
{{Cmd|# apk add dbus}}

Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched, it should load the desktop correctly

= =
* [[Dwm]]

[[Category:Desktop]]
[[category: Lua]]

AwesomeWM

2021-11-17T20:31:54Z

Ethanpil: /* Install packages */

[[file: awesome-01.png |thumb |Screenshot]]
{{TOC right}}

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
In order to install the awesome package (see "Install packages" below), you need to enable the community repository for your version. Uncomment {{codeline|http://<url>/alpine/<version>/community}} in {{path|/etc/apk/repositories}}. For example:
{{cat|/etc/apk/repositories|<nowiki># /etc/apk/repositories

#/media/sdb/apks
http://mirror.csclub.uwaterloo.ca/alpine/v3.14/main
http://mirror.csclub.uwaterloo.ca/alpine/v3.14/community
#http://mirror.csclub.uwaterloo.ca/alpine/v3.14/testing
</nowiki>
}}

= Install packages =
Install awesome, xterm, lua and terminus font. 
Depending on your network speed, it might take a few minutes.
{{Cmd|# apk add awesome xterm lua font-terminus}}

== Optional packages ==
=== Video and Input packages ===
You might want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset, install 'xf86-video-sis'. For Intel video chipset, install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# apk add xf86-input-synaptics}}

Run 'apk search xf86-video*' to see available xf86-video packages. 
Run 'apk search xf86-input*' to see available xf86-input packages. 

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

= Create user accounts =
Create a normal user account.
{{Cmd|# adduser <user>}}

Optionally, give that user sudo permissions in /etc/sudoers. When doing so, it is important to use the command: {{Cmd|# visudo}} This ensures that only one user is changing the file at any given time. Visudo has two modes: Command mode and Insert mode. To edit the file, use the arrows to navigate to the appropriate line and enter Insert mode by pressing the 'i' key. To save and exit, enter Command mode by pressing the 'Esc' key, then ':w' + 'enter' to save, and finally ':q' + 'enter' to quit.

Log out of the root account and log in to the newly created account.

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory}}

If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:

Install dbus from apk (you must be logged in as root for the step shown below)
{{Cmd|# apk add dbus}}

Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched, it should load the desktop correctly

= =
* [[Dwm]]

[[Category:Desktop]]
[[category: Lua]]

AwesomeWM

2021-11-17T20:31:28Z

Ethanpil: updated minimal instructions. removed extras from base install

[[file: awesome-01.png |thumb |Screenshot]]
{{TOC right}}

= Initial setup =
Start by booting Alpine (see [[Installation|these]] instructions on how to do that) 

= Enable Community Repository =
In order to install the awesome package (see "Install packages" below), you need to enable the community repository for your version. Uncomment {{codeline|http://<url>/alpine/<version>/community}} in {{path|/etc/apk/repositories}}. For example:
{{cat|/etc/apk/repositories|<nowiki># /etc/apk/repositories

#/media/sdb/apks
http://mirror.csclub.uwaterloo.ca/alpine/v3.14/main
http://mirror.csclub.uwaterloo.ca/alpine/v3.14/community
#http://mirror.csclub.uwaterloo.ca/alpine/v3.14/testing
</nowiki>
}}

= Install packages =
Install awesome, xterm. 
Depending on your network speed, it might take a few minutes.
{{Cmd|# apk add awesome xterm lua font-terminus}}

== Optional packages ==
=== Video and Input packages ===
You might want to install a package suitable for your video chipset and input devices. 
For example, if you have an Sis video chipset, install 'xf86-video-sis'. For Intel video chipset, install 'xf86-video-intel'. 
{{Cmd|# apk add xf86-video-sis}}
and / or
{{Cmd|# apk add xf86-input-synaptics}}

Run 'apk search xf86-video*' to see available xf86-video packages. 
Run 'apk search xf86-input*' to see available xf86-input packages. 

=== acpid ===
If you installed your Alpine Linux as a VirtualBox or VMWare guest, you might find it handy to be able execute an ACPI shutdown. 
{{Cmd|# rc-update add acpid}}

= Configure xorg-server =
On most systems, xorg should be able to autodetect all devices. However, you can still configure xorg-server manually by launching:
{{Cmd|# setup-xorg-base}}

= Create user accounts =
Create a normal user account.
{{Cmd|# adduser <user>}}

Optionally, give that user sudo permissions in /etc/sudoers. When doing so, it is important to use the command: {{Cmd|# visudo}} This ensures that only one user is changing the file at any given time. Visudo has two modes: Command mode and Insert mode. To edit the file, use the arrows to navigate to the appropriate line and enter Insert mode by pressing the 'i' key. To save and exit, enter Command mode by pressing the 'Esc' key, then ':w' + 'enter' to save, and finally ':q' + 'enter' to quit.

Log out of the root account and log in to the newly created account.

= Start your desktop =
{{Cmd|$ echo 'awesome' >> /home/<newuser>/.xinitrc}}
{{Cmd|$ mkdir /home/<newuser>/.config}}
{{Cmd|$ cp -r /etc/xdg/awesome /home/<newuser>/.config}}
{{Cmd|$ vi /home/<newuser>/.config/awesome/rc.lua}}

Start awesome.
{{Cmd|$ startx}}

= Troubleshooting =

D-Bus problems:

{{Cmd|D-Bus library appears to be incorrectly set up; failed to read machine uuid: Failed to open "/var/lib/dbus/machine-id": No such file or directory}}

If startx fails and returns an error about D-Bus failed to read machine uuid, as shown above, proceed as follows:

Install dbus from apk (you must be logged in as root for the step shown below)
{{Cmd|# apk add dbus}}

Log in or su to the root account, then launch the following command (Note: sudo does not work for this step):
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}

Now if startx is launched, it should load the desktop correctly

= =
* [[Dwm]]

[[Category:Desktop]]
[[category: Lua]]