I3wm: Difference between revisions

Latest revision as of 09:37, 13 January 2024

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 X11

Install X11 and set it up.

# setup-xorg-base

Install drivers

Ensure you have the required drivers.

# apk search xf86-input*

# apk search xf86-video*

Example driver installation

# apk add 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 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

@@ Line 1: / Line 1: @@
-= Initial setup =
+{{DISPLAYTITLE:i3wm}}
+== Initial setup ==
 I will assume you are working on a fresh, installation of Alpine standard.
 Otherwise see [[Installation|these]] instructions.
-= Enable Community Repository =
+== Enable Community Repository ==
 We need the Community Repository available for access to the i3 packages.
 Instructions are available on the [[Repositories#Enabling_the_community_repository|Repositories]] page.
-= Install drivers =
+== Install X11 ==
+Install X11 and set it up.
+{{Cmd|# setup-xorg-base}}
+== Install drivers ==
 Ensure you have the required drivers.
-{{Cmd|# apk search xf86-input*}}
-{{Cmd|# apk search xf86-video*}}
-These are the drivers I needed but the ones you need might differ.
+{{Cmd|# apk search {{pkg|xf86-input*}}}}
-{{Cmd|# apk add xf86-video-intel xf86-input-intel xf86-video-fbdev xf86-video-vesa}}
-= Install fonts =
+{{Cmd|# apk search {{pkg|xf86-video*}}}}
-Install some fonts. If you start i3 without fonts it will be unusable.
-{{Cmd|# apk add terminus-font}}
+=== Example driver installation ===
+{{Cmd|# apk add {{pkg|xf86-video-fbdev|arch=}} {{pkg|xf86-video-vesa|arch=}}}}
+== Install fonts ==
+Install [[Fonts|fonts]]. If you start i3 without fonts it will be unusable.
+{{Cmd|# apk add {{pkg|font-terminus|arch=}}}}
+== Install dbus ==
-= Install dbus =
 Install dbus and set it up.
-{{Cmd|# apk add dbus}}
+{{Cmd|# apk add {{pkg|dbus|arch=}}}}
 {{Cmd|# dbus-uuidgen > /var/lib/dbus/machine-id}}
 {{Cmd|# rc-update add dbus}}
-= Install X11 =
+== Install i3 ==
-Install X11 and set it up.
-{{Cmd|# setup-xorg-base }}
-= Install i3 etc =
 Install i3, the i3 status bar and a terminal.
-{{Cmd|# apk add i3wm i3status xterm}}
-= Set up a non-root account =
+{{Cmd|# apk add {{pkg|i3wm|arch=}} {{pkg|i3status|arch=}} {{pkg|xterm|arch=}}}}
-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 }}
+Set up a non-root account:
+{{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}}
-'''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.
-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]]
+[[category: Window Managers]]