Where Is the Karabiner-Elements Config File?
Karabiner karabiner.json in ~/.config/karabiner on macOS.
Last updated
Karabiner-Elements stores every key remap and complex modification in karabiner.json under the home config folder, auto-reloading on save. Complex rule imports land in assets beside it.
Version the whole karabiner folder since JSON edits fail silently on trailing commas. One bad bracket disables the entire keyboard layer.
Where Karabiner-Elements stores this, by platform
~/.config/karabiner/karabiner.json
Main config watched through the parent folder File System Events API. Imported rules live in assets/complex_modifications beside it. Symlink the folder, never the JSON file directly. Logs sit in ~/.local/share/karabiner/log.
Frequently asked questions
Why did Karabiner stop reloading config?
The parent folder got recreated or karabiner.json became a direct symlink. Restore a real folder and restart karabiner_console_user_server.
How do I sync Karabiner across Macs?
Dotfile the folder above including assets. Machine-specific device rules need per-host conditionals.
Notice an outdated path? Let us know.