Added way to set Firefox preferences via environment variables.
This commit is contained in:
parent
3b92cc215d
commit
5a635acffc
3 changed files with 123 additions and 0 deletions
38
appdefs.xml
38
appdefs.xml
|
@ -49,6 +49,44 @@ the host, `/dev/snd` must be exposed to the container by adding the
|
|||
`--device /dev/snd` parameter to the `docker run` command.
|
||||
</content>
|
||||
</section>
|
||||
<section>
|
||||
<title level="2">Setting {{ defs.app.friendly_name }} Preferences Via Environment Variables</title>
|
||||
<content>
|
||||
{{ defs.app.friendly_name }} preferences can be set via environment variables
|
||||
passed to the containter. During the startup, a script process all these
|
||||
variables and modify the preference file accordingly.
|
||||
|
||||
The name of the environment variable must start with `FF_PREF_`, followed by a
|
||||
string of your choice. For example, `FF_PREF_MY_PREF` is a valid name.
|
||||
|
||||
The content of the variable should be in the format `NAME=VAL`, where `NAME` is
|
||||
the name of the preference (as found in the `about:config` page) and `VAL` is
|
||||
its value. A value can be one of the following type:
|
||||
- string
|
||||
- integer
|
||||
- boolean
|
||||
It is important to note that a value of type `string` should be surrounded by
|
||||
double quotes. Other types don't need them.
|
||||
|
||||
For example, to set the `network.proxy.http` preference, one would pass the
|
||||
environment variable to the container by adding the following argument to the
|
||||
`docker run` command:
|
||||
|
||||
```
|
||||
-e "FF_PREF_HTTP_PROXY=network.proxy.http=\"proxy.example.com\""
|
||||
```
|
||||
|
||||
If a preference needs to be *removed*, its value should be set to `UNSET`. For
|
||||
example:
|
||||
|
||||
```
|
||||
-e "FF_PREF_HTTP_PROXY=network.proxy.http=UNSET
|
||||
```
|
||||
|
||||
**NOTE**: This is an advanced usage and it is recommended to set preferences
|
||||
via {{ defs.app.friendly_name }} directly.
|
||||
</content>
|
||||
</section>
|
||||
<section>
|
||||
<title level="2">Troubleshooting</title>
|
||||
<content/>
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue