Installing i3 on your workstation brings a predictable, keyboard-first workflow to everyday Linux use. This guide walks through practical choices so you can move from a blank machine to a stable i3 session without trial and error.
Every distribution handles package names and init systems slightly differently, yet the core steps remain consistent. Understanding dependencies, display managers, and window‑related nuances helps you avoid common configuration pitfalls.
Quick Reference at a Glance
| Distribution | Package Name | Display Manager | Start i3 |
|---|---|---|---|
| Ubuntu | i3 | GDM3 | Select i3 on login screen |
| Fedora | i3 | GDM | Choose i3 on session menu |
| Arch Linux | i3-wm | SDDM | Pick i3 at login |
| Debian | LightDM | Select i3 session |
Planning Your i3 Installation
Before you run the first install command, decide whether you want i3 as your primary desktop or as a lightweight alternative. Consider hardware limits, graphics drivers, and whether you need integrated GPU support for media playback.
Check your distribution’s repository freshness and confirm that you have a working internet connection during install. Back up important configurations, especially if you are replacing an existing window manager or desktop environment.
Keep a terminal open in a virtual console or through a keyboard shortcut so you can troubleshoot display manager issues without losing your current session state. A stable internet connection and a user with sudo privileges are the basic prerequisites.
Package Naming and Dependencies
Distribution package names vary, but the core i3 package is usually called i3 or i4. Dependencies pull in dmenu for launcher prompts, i3status for the status bar, and xwayland for legacy X11 apps.
Some distros split status bar components into i3status or i3blocks, while others offer i3lock for screen locking and i3-sensible-tools for default apps. Verify the exact package list with your package manager’s search function before proceeding.
Updating the package index, installing i3, and then installing status bar tools in a single session reduces dependency resolution conflicts and keeps your system consistent.
Display Manager and Session Selection
Most modern installations use a display manager such as GDM, LightDM, or SDDM to handle login and session choices. Installing i3 does not automatically configure the display manager to list i3 as a valid session type.
On Ubuntu, the i3 package registers a session file automatically, while on Arch and Fedora you may need to ensure the package is installed in the correct environment and that the display manager is restarted. A missing session entry usually means the display manager needs a refresh or a manual symlink.
Test the setup by rebooting, selecting i3 from the session menu, and confirming that the i3 bar, default modifier key, and basic windows behave as expected without manual intervention.
Minimal Configuration and First Launch
After the first start, i3 loads a configuration file typically located at ~/.config/i3/config. You can accept defaults, assign a modifier key, and define keybindings for screenshots, lock, and terminal launch.
Use the i3-config-wizard or manually verify that your keyboard layout, modifier keys, and workspace names match your habits. Small changes to the config file can fix focus behavior, modifier conflicts, and workspace persistence across restarts.
Enable a tray, status command, and gaps early in the process so your visible workspace remains consistent and predictable. Save a backup of your config file after each meaningful change to simplify rollbacks.
Streamlined Workflow After Installation
- Install i3 and core tools in one session with a single package manager command.
- Verify the display manager shows an i3 session option and test it after reboot.
- Customize keybindings, status command, and tray settings to match your daily tasks.
- Back up configuration files regularly and keep the package index updated.
- Use a terminal multiplexer like tmux inside i3 to preserve workflows across disconnects.
FAQ
Reader questions
How do I start i3 on an existing Ubuntu installation without reinstalling?
Install the i3 package from the default repositories, log out, select the i3 session from the gear icon on the login screen, and enter your password as usual.
What should I do if the i3 session fails to start and returns to the login screen?
Check the i3 log with Alt+Shift+F2, review the last few lines in ~/.i3/config, fix syntax errors, and ensure your display manager service is active and enabled.
Can i3 coexist with other desktop environments on the same machine?
Yes, you can have GNOME, KDE, XFCE, and i3 installed side by side; the display manager will list each environment and let you choose which one to launch per user.
Is Wayland supported in the default i3 setup?
Default i3 is X11–based, but many distributions offer i3 with Wayland support through i3- Wayland or wlroots-based variants if you need a native Wayland workflow.