I3wm: Difference between revisions

From Alpine Linux
m (font-terminus)
(added category and formatting)
Line 1: Line 1:
= Initial setup =
== Initial setup ==
 
I will assume you are working on a fresh, installation of Alpine standard.
I will assume you are working on a fresh, installation of Alpine standard.
Otherwise see [[Installation|these]] instructions.
Otherwise see [[Installation|these]] instructions.


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


= Install drivers =
== Install drivers ==
 
Ensure you have the required drivers.
Ensure you have the required drivers.
{{Cmd|# apk search xf86-input*}}
{{Cmd|# apk search xf86-input*}}
{{Cmd|# apk search xf86-video*}}
{{Cmd|# apk search xf86-video*}}


These are the drivers I needed but the ones you need might differ.
=== Example driver installation ===
 
{{Cmd|# apk add xf86-video-intel xf86-input-intel xf86-video-fbdev xf86-video-vesa}}
{{Cmd|# apk add xf86-video-intel xf86-input-intel xf86-video-fbdev xf86-video-vesa}}


= Install fonts =
== Install fonts ==
Install some fonts. If you start i3 without fonts it will be unusable.
 
Install [[Fonts|fonts]]. If you start i3 without fonts it will be unusable.
 
{{Cmd|# apk add font-terminus}}
{{Cmd|# apk add font-terminus}}


= Install dbus =
== Install dbus ==
 
Install dbus and set it up.
Install dbus and set it up.
{{Cmd|# apk add dbus}}
{{Cmd|# apk add dbus}}
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}
{{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}
{{Cmd|# rc-update add dbus}}
{{Cmd|# rc-update add dbus}}


= Install X11 =
== Install X11 ==
 
Install X11 and set it up.
Install X11 and set it up.
{{Cmd|# setup-xorg-base }}


= Install i3 etc =
{{Cmd|# setup-xorg-base}}
 
== Install i3 ==
 
Install i3, the i3 status bar and a terminal.
Install i3, the i3 status bar and a terminal.
{{Cmd|# apk add i3wm i3status xterm}}
{{Cmd|# apk add i3wm i3status xterm}}


= Set up a non-root account =
== Set up a non-root account ==
Set up a non-root account. (Call this whatever you like.)
 
{{Cmd|# adduser thomas }}
Set up a non-root account:
{{Cmd|# addgroup thomas input }}
 
{{Cmd|# addgroup thomas video }}
{{Cmd|# adduser ''new-user''}}
 
{{Cmd|# addgroup ''new-user'' input}}
 
{{Cmd|# addgroup ''new-user'' video}}
 
== Test ==
 
Now you can start i3 manually:


= Test =
Now you can start i3 manually.
{{Cmd|# startx /usr/bin/i3}}
{{Cmd|# startx /usr/bin/i3}}


'''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 [https://i3wm.org/docs/userguide.html i3 user guide].
{{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 [https://i3wm.org/docs/userguide.html i3 user guide].}}
 
== Starting i3 on login ==


= Starting i3 on login =
To have i3 start automatically on login, you should set up xinit.
To have i3 start automatically on login, you should set up xinit.
There are different ways to do this. The
 
[https://wiki.archlinux.org/title/Xinit arch wiki]
There are different ways to do this. The [https://wiki.archlinux.org/title/Xinit ArchWiki]
has good, transferrable information on this.
has information on this.
 
{{Todo|add section on Xinit}}
 
[[Category:Desktop]]

Revision as of 09:56, 17 April 2023

Initial setup

I will assume you are working on a fresh, installation of Alpine standard. Otherwise see these instructions.

Enable Community Repository

We need the Community Repository available for access to the i3 packages. Instructions are available on the Repositories page.

Install drivers

Ensure you have the required drivers.

# apk search xf86-input*

# apk search xf86-video*

Example driver installation

# apk add xf86-video-intel xf86-input-intel xf86-video-fbdev xf86-video-vesa

Install fonts

Install fonts. If you start i3 without fonts it will be unusable.

# apk add font-terminus

Install dbus

Install dbus and set it up.

# apk add dbus

# dbus-uuidgen > /var/lib/dbus/machine-id

# rc-update add dbus

Install X11

Install X11 and set it up.

# setup-xorg-base

Install i3

Install i3, the i3 status bar and a terminal.

# apk add i3wm i3status xterm

Set up a non-root account

Set up a non-root account:

# adduser new-user

# addgroup new-user input

# addgroup new-user video

Test

Now you can start i3 manually:

# startx /usr/bin/i3

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 i3 user guide.

Starting i3 on login

To have i3 start automatically on login, you should set up xinit.

There are different ways to do this. The ArchWiki has information on this.

Todo: add section on Xinit