Skip to content

Commit 7f8bbc9

Browse files
committed
mkFirefoxModule: document impermanence extensions
Clarify that extensions.autoDisableScopes only handles manual extension approval. Firefox still owns mutable extension runtime state, so impermanent setups must persist the relevant profile state or configure supported extension settings declaratively. Closes nix-community#6398
1 parent c97d921 commit 7f8bbc9

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

modules/programs/firefox/mkFirefoxModule.nix

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -692,6 +692,20 @@ in
692692
`"extensions.autoDisableScopes" = 0;`
693693
to
694694
[{option}`${moduleName}.profiles.<profile>.settings`](#opt-${moduleName}.profiles._name_.settings)
695+
696+
On systems using impermanence, this only prevents
697+
${name} from requiring manual extension approval. It
698+
does not preserve extension runtime state such as
699+
extension UUIDs, logins, local storage, or
700+
per-extension data. Persist the ${name} profile state
701+
needed by your extensions, or configure supported
702+
extension settings declaratively with
703+
[{option}`${moduleName}.profiles.<profile>.extensions.settings`](#opt-${moduleName}.profiles._name_.extensions.settings).
704+
705+
Persisting only the `extensions` directory is generally
706+
not sufficient, because ${name} stores extension state
707+
in other profile files and databases that are managed
708+
outside Home Manager.
695709
'';
696710
};
697711

0 commit comments

Comments
 (0)