View source for Fluxbox

[http://fluxbox.org Fluxbox] is an easy and fast X11 window manager based on BlackBox.

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

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

= Install packages =
Install fluxbox, xterm, and terminus font.<BR>

{{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.<BR>
{{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].

[[Category:Desktop]]