> ## Documentation Index
> Fetch the complete documentation index at: https://docs.focusme.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux

> Linux-specific features, setup, and troubleshooting for FocusMe.

## Supported Distributions

FocusMe supports **Debian-based** Linux distributions:

* Ubuntu 20.04+
* Linux Mint
* Debian 11+
* Pop!\_OS
* Other Debian derivatives

## Display Server Support

| Display Server | Status                                                            |
| -------------- | ----------------------------------------------------------------- |
| **X11**        | Full support — window detection, title matching, global shortcuts |
| **Wayland**    | Supported with some limitations                                   |

## Installation

```bash theme={null}
chmod +x FocusMe-*.sh
sudo ./FocusMe-*.sh
```

The installer:

* Installs FocusMe to `/Applications/`
* Configures FocusMe to start automatically on login
* Adds desktop integration (application menu entry, icons)
* Bundles all required Qt libraries (no separate Qt installation needed)

## Troubleshooting

### Window detection not working

1. Some tiling window managers may need additional configuration
2. On Wayland, window detection may be limited depending on your compositor

### Browser extension not connecting

Reinstalling FocusMe should fix the connection. See [Browser Extension](/advanced/browser-extension) for details.

### Uninstalling

```bash theme={null}
sudo /Applications/FocusMe/focusme_uninstall_linux.sh
```