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

# otter-polkit

> Session polkit agent with a password dialog and optional fingerprint auth.

`otter-polkit` is the session polkit agent. Elevated-privilege prompts (package installs, disk operations) show as a password dialog on a layer-shell overlay.

## Usage

```bash theme={null}
otter-polkit
```

Autostart at login: see [Session setup](/desktop/session-setup).

Test with:

```bash theme={null}
pkexec echo hello
```

A password dialog should appear on your focused output.

## Configuration

Config file: `~/.config/otter-shell/otter-polkit.conf`

```conf theme={null}
font_size = 14
title_font_size = 16
dialog_width = 420
dialog_padding = 24
border_width = 2
border_radius = 8
input_height = 36
button_height = 36
max_retries = 3
enable_fingerprint = true
```

Colors inherit from [theme.conf](/configuration/themes) when not set.

## Keybindings

| Key    | Action                |
| ------ | --------------------- |
| Escape | Cancel authentication |
| Enter  | Submit password       |
| Ctrl+U | Clear password field  |

Fingerprint auth works via fprintd when `enable_fingerprint = true` and fprintd is configured for the user.

## Dependencies

Requires D-Bus (fprintd integration). Build with `-Denable_dbus=false` disables fingerprint support.