Installing i3 on your Linux machine gives you a lightweight, highly configurable tiling window manager that maximizes screen real estate and productivity. This guide walks through practical steps, common pitfalls, and configuration tips to get your i3 setup running smoothly.
Whether you are migrating from a traditional desktop environment or setting up a new machine, understanding how i3 handles workspaces, modifiers, and keybindings will help you avoid frustration and build a reliable daily driver.
| Aspect | Details | Typical Default | Recommended for New Users |
|---|---|---|---|
| Window Manager | i3wm offers dynamic tiling, manual floating, and nested layouts | Tiling with gaps | Enable gaps and basic status bar first |
| Modifier Key | Default is Mod4 (Super/Windows key), usable as Mod1 (Alt) too | Super | Keep Mod4 consistent across config and shortcuts |
| Workspaces | Number-based or named, supports dynamic creation | 1–10 numeric | Map apps to dedicated workspaces early |
| Configuration File | ~/.config/i3/config or ~/.i3/config | Auto-generated on first launch | Back up and annotate your config |
Getting Started with i3 Install and Desktop Integration
Before you install i3, verify your distribution choice and desktop compatibility. i3 runs on almost all Linux desktops, but integrating status bars, tray icons, and notifications may require additional packages.
Plan your root partition, swap or swap file, and ensure your graphics drivers are in place. Wayland versus X11 matters because i3 is primarily X11-focused, and some compositors may need tweaks.
Installation Methods Overview
Most package managers provide a current version of i3, and you can choose between meta packages that pull recommended components or a minimal core to build on later.
Essential i3 Configuration Steps
After you successfully install i3, generate a base configuration so you have a working starting point. The default config includes commented examples for gaps, borders, and keybindings that you can uncomment and adjust.
Set your Mod1 and Mod4 keys carefully if you plan to use Alt as a modifier, and test simple bindings like Mod+Enter to open a terminal before adding complex layouts.
Organize your config with includes for separate files per function, such as workspace rules, startup applications, and custom shortcuts, to keep changes manageable over time.
Key Bindings and Workspaces
Create logical workspaces for web, development, documents, and communication, and assign applications to them so each workspace feels like a dedicated desk.
Use both numeric and named workspaces to balance quick access and semantic meaning, and learn how to move containers between workspaces without losing state.
Adding a Status Bar and System Integration
A status bar provides workspace indicators, keyboard layout, battery, clock, and system information, turning i3 from a minimal shell into a fully featured environment.
i3status, i3blocks, or polybar are popular choices, and you can customize colors, icons, and update intervals to match your workflow and screen space.
Startup Applications and Autostart Services
Define per-application rules to float specific windows, enable kill hints for shortcuts, and set focus to new windows or ignore certain dialogs based on class or window role.
Autostart network managers, screen lockers, background painters, and notification daemons from your config so your environment behaves consistently after each reboot.
Refining and Maintaining Your i3 Environment
- Treat your config as versioned code with clear comments and logical sections
- Test major changes in a spare session or virtual console before applying globally
- Document custom keybindings so new users or your future self understand the intent
- Monitor resource usage from your status bar and tweak gaps or borders for readability
- Regularly update i3 and related components to benefit from security fixes and improvements
- Create workspace templates for common workflows to reduce repetitive setup time
- Use consistent naming for workspaces and bindings across machines for muscle memory
FAQ
Reader questions
How do I install i3 on Ubuntu or Debian based distributions?
Update your package index and install i3 and i3status with your package manager, then create a display manager session or start i3 from the console as your window manager.
What should I do if keyboard shortcuts are not working after i3 install?
Check your modifier key configuration, ensure no conflicting background services grabbed the keys, reload your config with Mod+Shift+C or restart i3 safely with Mod+Shift+R.
Can i3 work with multiple monitors and what config settings are needed?
Yes, use xrandr or autorandr within your startup applications to assign workspaces to outputs, set primary displays, and define per-monitor workspace naming for consistent layouts.
How can I keep my i3 configuration backed up and share it across machines?
Store your config and i3status configuration in a Git repository, use symbolic links or dotfile managers, and periodically test your setup in a virtual machine or spare hardware.