WindowsmacOSLinux

Where Does qutebrowser Store Config and Data?

qutebrowser config and data folders on Windows, macOS and Linux with autoconfig, bookmarks and sessions.

Last updated

qutebrowser splits config from data the XDG way. Settings live in the config tree while history, bookmarks, sessions and web storage sit in the data tree.

The interactive :set customizations land in autoconfig.yml, separate from a hand-written config.py. Back up both files and the data dir covers everything.

Where qutebrowser stores this, by platform

Windows
%APPDATA%\qutebrowser

Holds config\config.py and config\autoconfig.yml plus the data tree with history.sqlite, bookmarks and sessions. Paste the path into File Explorer to jump there.

macOS
~/Library/Application Support/qutebrowser

Same config plus data layout as Windows. Use Finder Go > Go to Folder.

Linux
~/.config/qutebrowser

Config tree with config.py and autoconfig.yml. Runtime data sits next door at ~/.local/share/qutebrowser, including history, sessions and the adblock cache.

Frequently asked questions

Which qutebrowser file holds my :set changes?

autoconfig.yml in the config folder. Your hand-written config.py stays untouched, so both files matter for a full backup.

How do I migrate qutebrowser to a new machine?

Copy the config folder and the data folder to the same spots. Sessions and per-site settings in the data tree come along.

Notice an outdated path? Let us know.