rougail-tutorials/DOCUMENTATION.md

# Firefox

> [!NOTE]
> 
> This family is a namespace.\
> **Path**: firefox\
> `basic`

| Variable                                                                                                                                                                                      | Description                                                                                                                                                                                                                                                                  |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="firefox.proxy_mode" name="firefox.proxy_mode">firefox.proxy_mode</a>**<br/>[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` | Configure Proxy Access to the Internet.<br/>**Choices**: <br/>•&nbsp;No proxy **← (default)**<br/>•&nbsp;Auto-detect proxy settings for this network<br/>•&nbsp;Use system proxy settings<br/>•&nbsp;Manual proxy configuration<br/>•&nbsp;Automatic proxy configuration URL |

## Manual proxy configuration

> [!NOTE]
> 
> **Path**: firefox.manual\
> `basic` *`disabled`*\
> **Disabled**: when the variable "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" hasn't the value "Manual proxy configuration".

### HTTP Proxy

> [!NOTE]
> 
> **Path**: firefox.manual.http_proxy\
> `basic`

| Variable                                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                      |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="firefox.manual.http_proxy.address" name="firefox.manual.http_proxy.address">firefox.manual.http_proxy.address</a>**<br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` | HTTP proxy address.<br/>**Validators**: <br/>•&nbsp;type domainname<br/>•&nbsp;the domain name can be an IP                                                                                                                      |
| **<a id="firefox.manual.http_proxy.port" name="firefox.manual.http_proxy.port">firefox.manual.http_proxy.port</a>**<br/>[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`             | HTTP proxy port.<br/>**Validators**: <br/>•&nbsp;well-known ports (1 to 1023) are allowed<br/>•&nbsp;registred ports (1024 to 49151) are allowed<br/>•&nbsp;private ports (greater than 49152) are allowed<br/>**Default**: 8080 |

| Variable                                                                                                                                                                                                                     | Description                                          |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
| **<a id="firefox.manual.use_for_https" name="firefox.manual.use_for_https">firefox.manual.use_for_https</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` | Also use this proxy for HTTPS.<br/>**Default**: true |

### HTTPS Proxy

> [!NOTE]
> 
> **Path**: firefox.manual.https_proxy\
> `standard` *`hidden`*\
> **Hidden**: when the variable "[Also use this proxy for HTTPS](#firefox.manual.use_for_https)" has the value "true".

| Variable                                                                                                                                                                                                                                          | Description                                                                                                                                                                                                                                                                                                  |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="firefox.manual.https_proxy.address" name="firefox.manual.https_proxy.address">firefox.manual.https_proxy.address</a>**<br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` | HTTPS proxy address.<br/>**Validators**: <br/>•&nbsp;type domainname<br/>•&nbsp;the domain name can be an IP<br/>**Default**: the value of the variable "[HTTP proxy address](#firefox.manual.http_proxy.address)".                                                                                          |
| **<a id="firefox.manual.https_proxy.port" name="firefox.manual.https_proxy.port">firefox.manual.https_proxy.port</a>**<br/>[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                | HTTPS proxy port.<br/>**Validators**: <br/>•&nbsp;well-known ports (1 to 1023) are allowed<br/>•&nbsp;registred ports (1024 to 49151) are allowed<br/>•&nbsp;private ports (greater than 49152) are allowed<br/>**Default**: the value of the variable "[HTTP proxy port](#firefox.manual.http_proxy.port)". |

### SOCKS Proxy

> [!NOTE]
> 
> **Path**: firefox.manual.socks_proxy\
> `standard`

| Variable                                                                                                                                                                                                                                          | Description                                                                                                                                                                                                                                                                                                  |
|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="firefox.manual.socks_proxy.address" name="firefox.manual.socks_proxy.address">firefox.manual.socks_proxy.address</a>**<br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` | SOCKS proxy address.<br/>**Validators**: <br/>•&nbsp;type domainname<br/>•&nbsp;the domain name can be an IP<br/>**Default**: the value of the variable "[HTTP proxy address](#firefox.manual.http_proxy.address)".                                                                                          |
| **<a id="firefox.manual.socks_proxy.port" name="firefox.manual.socks_proxy.port">firefox.manual.socks_proxy.port</a>**<br/>[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                | SOCKS proxy port.<br/>**Validators**: <br/>•&nbsp;well-known ports (1 to 1023) are allowed<br/>•&nbsp;registred ports (1024 to 49151) are allowed<br/>•&nbsp;private ports (greater than 49152) are allowed<br/>**Default**: the value of the variable "[HTTP proxy port](#firefox.manual.http_proxy.port)". |
| **<a id="firefox.manual.socks_proxy.version" name="firefox.manual.socks_proxy.version">firefox.manual.socks_proxy.version</a>**<br/>[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`     | SOCKS host version used by proxy.<br/>**Choices**: <br/>•&nbsp;v4<br/>•&nbsp;v5 **← (default)**                                                                                                                                                                                                              |

| Variable                                                                                                                                                                                                                                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="firefox.auto" name="firefox.auto">firefox.auto</a>**<br/>[`web address`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` *`disabled`*                                                   | Automatic proxy configuration URL.<br/>**Validators**: <br/>•&nbsp;well-known ports (1 to 1023) are allowed<br/>•&nbsp;registred ports (1024 to 49151) are allowed<br/>•&nbsp;type domainname<br/>•&nbsp;the domain name can be a hostname<br/>**Disabled**: when the variable "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" hasn't the value "Automatic proxy configuration URL".                                                                                                                                                                                  |
| **<a id="firefox.no_proxy" name="firefox.no_proxy">firefox.no_proxy</a>**<br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `standard` *`disabled`* `unique`                             | Address for which proxy will be desactivated.<br/>Connections to localhost, 127.0.0.1/8 and ::1 are never proxied.<br/>**Validators**: <br/>•&nbsp;type domainname<br/>•&nbsp;the domain name can starts by a dot<br/>•&nbsp;the domain name can be a hostname<br/>•&nbsp;the domain name can be an IP<br/>•&nbsp;the domain name can be network in CIDR format<br/>**Examples**: <br/>•&nbsp;.mozilla.org<br/>•&nbsp;.net.nz<br/>•&nbsp;192.168.1.0/24<br/>**Disabled**: when the variable "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" has the value "No proxy". |
| **<a id="firefox.prompt_authentication" name="firefox.prompt_authentication">firefox.prompt_authentication</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`* | Prompt for authentication if password is saved.<br/>**Default**: true<br/>**Disabled**: when the variable "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" has the value "No proxy".                                                                                                                                                                                                                                                                                                                                                                                   |
| **<a id="firefox.proxy_dns_socks5" name="firefox.proxy_dns_socks5">firefox.proxy_dns_socks5</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `advanced` `mandatory` *`disabled`*                | Use proxy DNS when using SOCKS v5.<br/>**Default**: false<br/>**Disabled**: if "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" is not "Manual proxy configuration"<br/>or "[SOCKS host version used by proxy](#firefox.manual.socks_proxy.version)" is "v4".                                                                                                                                                                                                                                                                                                          |

## DNS over HTTPS

> [!NOTE]
> 
> **Path**: firefox.dns_over_https\
> `basic`

| Variable                                                                                                                                                                                                                                                                     | Description                                                                                                                                                                                                                                                                                                                                                  |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **<a id="firefox.dns_over_https.enable_dns_over_https" name="firefox.dns_over_https.enable_dns_over_https">firefox.dns_over_https.enable_dns_over_https</a>**<br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` | Enable DNS over HTTPS.<br/>**Default**: false                                                                                                                                                                                                                                                                                                                |
| **<a id="firefox.dns_over_https.provider" name="firefox.dns_over_https.provider">firefox.dns_over_https.provider</a>**<br/>[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` *`disabled`*                            | Use Provider.<br/>**Choices**: <br/>•&nbsp;Cloudflare **← (default)**<br/>•&nbsp;NextDNS<br/>•&nbsp;Custom<br/>**Disabled**: when the variable "[Enable DNS over HTTPS](#firefox.dns_over_https.enable_dns_over_https)" has the value "false".                                                                                                               |
| **<a id="firefox.dns_over_https.custom_dns_url" name="firefox.dns_over_https.custom_dns_url">firefox.dns_over_https.custom_dns_url</a>**<br/>[`web address`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` *`disabled`*        | Custom DNS URL.<br/>**Validators**: <br/>•&nbsp;well-known ports (1 to 1023) are allowed<br/>•&nbsp;registred ports (1024 to 49151) are allowed<br/>•&nbsp;type domainname<br/>•&nbsp;the domain name can be a hostname<br/>•&nbsp;must starts with 'https://' only<br/>**Disabled**: if "[Use Provider](#firefox.dns_over_https.provider)" is not "Custom". |

# FoxyProxy

> [!NOTE]
> 
> This family is a namespace.\
> **Path**: foxyproxy\
> `standard`

## Proxy configuration

> [!NOTE]
> 
> This family contains lists of variable blocks.\
> **Path**: foxyproxy.proxies\
> `standard`

| Variable                                                                                                                                                                                                             | Description                                                                                                                  |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|
| **<a id="foxyproxy.proxies.title" name="foxyproxy.proxies.title">foxyproxy.proxies.title</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `standard` `unique` | Title or Description.                                                                                                        |
| **<a id="foxyproxy.proxies.color" name="foxyproxy.proxies.color">foxyproxy.proxies.color</a>**<br/>[`regexp`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`         | Color.<br/>**Validator**: text based with regular expressions "^#(?:[0-9a-f]{3}){1,2}$"<br/>**Default**: random color value. |
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`# Firefox`
[tutorial v1.1_051] A conditional disabled family (config and doc) 2026-04-18 21:46:53 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`> [!NOTE]`
			`>`
			`> This family is a namespace.\`
			`> Path: firefox\`
			> `basic`

			`\| Variable \| Description \|`
			`\|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|`
			\| <a id="firefox.proxy_mode" name="firefox.proxy_mode">firefox.proxy_mode</a><br/>[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| Configure Proxy Access to the Internet.<br/>Choices: <br/>• No proxy ← (default)<br/>• Auto-detect proxy settings for this network<br/>• Use system proxy settings<br/>• Manual proxy configuration<br/>• Automatic proxy configuration URL \|

			`## Manual proxy configuration`
[tutorial v1.1_051] A conditional disabled family (config and doc) 2026-04-18 21:46:53 +02:00
			`> [!NOTE]`
			`>`
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`> Path: firefox.manual\`
[tutorial v1.1_130] A variable in avanced mode (config and doc) 2026-04-18 21:48:35 +02:00			> `basic` `disabled`\
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`> Disabled: when the variable "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" hasn't the value "Manual proxy configuration".`
[tutorial v1.1_051] A conditional disabled family (config and doc) 2026-04-18 21:46:53 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`### HTTP Proxy`
[tutorial v1.1_051] A conditional disabled family (config and doc) 2026-04-18 21:46:53 +02:00
			`> [!NOTE]`
			`>`
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`> Path: firefox.manual.http_proxy\`
[tutorial v1.1_130] A variable in avanced mode (config and doc) 2026-04-18 21:48:35 +02:00			> `basic`
[tutorial v1.1_051] A conditional disabled family (config and doc) 2026-04-18 21:46:53 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`\| Variable \| Description \|`
			`\|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|`
			\| <a id="firefox.manual.http_proxy.address" name="firefox.manual.http_proxy.address">firefox.manual.http_proxy.address</a><br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` \| HTTP proxy address.<br/>Validators: <br/>• type domainname<br/>• the domain name can be an IP \|
			\| <a id="firefox.manual.http_proxy.port" name="firefox.manual.http_proxy.port">firefox.manual.http_proxy.port</a><br/>[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| HTTP proxy port.<br/>Validators: <br/>• well-known ports (1 to 1023) are allowed<br/>• registred ports (1024 to 49151) are allowed<br/>• private ports (greater than 49152) are allowed<br/>Default: 8080 \|
[tutorial v1.1_051] A conditional disabled family (config and doc) 2026-04-18 21:46:53 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`\| Variable \| Description \|`
			`\|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|------------------------------------------------------\|`
			\| <a id="firefox.manual.use_for_https" name="firefox.manual.use_for_https">firefox.manual.use_for_https</a><br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| Also use this proxy for HTTPS.<br/>Default: true \|
[tutorial v1.1_053] A conditional hidden family (config and doc) 2026-04-18 21:47:02 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`### HTTPS Proxy`
[tutorial v1.1_053] A conditional hidden family (config and doc) 2026-04-18 21:47:02 +02:00
			`> [!NOTE]`
			`>`
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`> Path: firefox.manual.https_proxy\`
[tutorial v1.1_130] A variable in avanced mode (config and doc) 2026-04-18 21:48:35 +02:00			> `standard` `hidden`\
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`> Hidden: when the variable "[Also use this proxy for HTTPS](#firefox.manual.use_for_https)" has the value "true".`
[tutorial v1.1_081] Add a variable in a family with custom type (config and doc) 2026-04-18 21:47:37 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			\| Variable \| Description \|
			\|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|
			\| <a id="firefox.manual.https_proxy.address" name="firefox.manual.https_proxy.address">firefox.manual.https_proxy.address</a><br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| HTTPS proxy address.<br/>Validators: <br/>• type domainname<br/>• the domain name can be an IP<br/>Default: the value of the variable "[HTTP proxy address](#firefox.manual.http_proxy.address)". \|
			\| <a id="firefox.manual.https_proxy.port" name="firefox.manual.https_proxy.port">firefox.manual.https_proxy.port</a><br/>[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| HTTPS proxy port.<br/>Validators: <br/>• well-known ports (1 to 1023) are allowed<br/>• registred ports (1024 to 49151) are allowed<br/>• private ports (greater than 49152) are allowed<br/>Default: the value of the variable "[HTTP proxy port](#firefox.manual.http_proxy.port)". \|
[tutorial v1.1_081] Add a variable in a family with custom type (config and doc) 2026-04-18 21:47:37 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`### SOCKS Proxy`
[tutorial v1.1_081] Add a variable in a family with custom type (config and doc) 2026-04-18 21:47:37 +02:00
			`> [!NOTE]`
			`>`
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`> Path: firefox.manual.socks_proxy\`
[tutorial v1.1_130] A variable in avanced mode (config and doc) 2026-04-18 21:48:35 +02:00			> `standard`

[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			\| Variable \| Description \|
			\|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|
			\| <a id="firefox.manual.socks_proxy.address" name="firefox.manual.socks_proxy.address">firefox.manual.socks_proxy.address</a><br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| SOCKS proxy address.<br/>Validators: <br/>• type domainname<br/>• the domain name can be an IP<br/>Default: the value of the variable "[HTTP proxy address](#firefox.manual.http_proxy.address)". \|
			\| <a id="firefox.manual.socks_proxy.port" name="firefox.manual.socks_proxy.port">firefox.manual.socks_proxy.port</a><br/>[`port`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| SOCKS proxy port.<br/>Validators: <br/>• well-known ports (1 to 1023) are allowed<br/>• registred ports (1024 to 49151) are allowed<br/>• private ports (greater than 49152) are allowed<br/>Default: the value of the variable "[HTTP proxy port](#firefox.manual.http_proxy.port)". \|
			\| <a id="firefox.manual.socks_proxy.version" name="firefox.manual.socks_proxy.version">firefox.manual.socks_proxy.version</a><br/>[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| SOCKS host version used by proxy.<br/>Choices: <br/>• v4<br/>• v5 ← (default) \|
[tutorial v1.1_130] A variable in avanced mode (config and doc) 2026-04-18 21:48:35 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			\| Variable \| Description \|
			\|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|
			\| <a id="firefox.auto" name="firefox.auto">firefox.auto</a><br/>[`web address`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` `disabled` \| Automatic proxy configuration URL.<br/>Validators: <br/>• well-known ports (1 to 1023) are allowed<br/>• registred ports (1024 to 49151) are allowed<br/>• type domainname<br/>• the domain name can be a hostname<br/>Disabled: when the variable "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" hasn't the value "Automatic proxy configuration URL". \|
			\| <a id="firefox.no_proxy" name="firefox.no_proxy">firefox.no_proxy</a><br/>[`domainname`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `standard` `disabled` `unique` \| Address for which proxy will be desactivated.<br/>Connections to localhost, 127.0.0.1/8 and ::1 are never proxied.<br/>Validators: <br/>• type domainname<br/>• the domain name can starts by a dot<br/>• the domain name can be a hostname<br/>• the domain name can be an IP<br/>• the domain name can be network in CIDR format<br/>Examples: <br/>• .mozilla.org<br/>• .net.nz<br/>• 192.168.1.0/24<br/>Disabled: when the variable "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" has the value "No proxy". \|
			\| <a id="firefox.prompt_authentication" name="firefox.prompt_authentication">firefox.prompt_authentication</a><br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `disabled` \| Prompt for authentication if password is saved.<br/>Default: true<br/>Disabled: when the variable "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" has the value "No proxy". \|
			\| <a id="firefox.proxy_dns_socks5" name="firefox.proxy_dns_socks5">firefox.proxy_dns_socks5</a><br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `advanced` `mandatory` `disabled` \| Use proxy DNS when using SOCKS v5.<br/>Default: false<br/>Disabled: if "[Configure Proxy Access to the Internet](#firefox.proxy_mode)" is not "Manual proxy configuration"<br/>or "[SOCKS host version used by proxy](#firefox.manual.socks_proxy.version)" is "v4". \|
[tutorial v1.1_140] A boolean variable (config and doc) 2026-04-18 21:48:40 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`## DNS over HTTPS`
[tutorial v1.1_140] A boolean variable (config and doc) 2026-04-18 21:48:40 +02:00
			`> [!NOTE]`
			`>`
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			`> Path: firefox.dns_over_https\`
[tutorial v1.1_142] A web_address variable (config and doc) 2026-04-18 21:48:49 +02:00			> `basic`
[tutorial v1.1_140] A boolean variable (config and doc) 2026-04-18 21:48:40 +02:00
[tutorial v1.1_160] Namespace (config and doc) 2026-04-18 21:48:57 +02:00			\| Variable \| Description \|
			\|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|
			\| <a id="firefox.dns_over_https.enable_dns_over_https" name="firefox.dns_over_https.enable_dns_over_https">firefox.dns_over_https.enable_dns_over_https</a><br/>[`boolean`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| Enable DNS over HTTPS.<br/>Default: false \|
			\| <a id="firefox.dns_over_https.provider" name="firefox.dns_over_https.provider">firefox.dns_over_https.provider</a><br/>[`choice`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `disabled` \| Use Provider.<br/>Choices: <br/>• Cloudflare ← (default)<br/>• NextDNS<br/>• Custom<br/>Disabled: when the variable "[Enable DNS over HTTPS](#firefox.dns_over_https.enable_dns_over_https)" has the value "false". \|
			\| <a id="firefox.dns_over_https.custom_dns_url" name="firefox.dns_over_https.custom_dns_url">firefox.dns_over_https.custom_dns_url</a><br/>[`web address`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `basic` `mandatory` `disabled` \| Custom DNS URL.<br/>Validators: <br/>• well-known ports (1 to 1023) are allowed<br/>• registred ports (1024 to 49151) are allowed<br/>• type domainname<br/>• the domain name can be a hostname<br/>• must starts with 'https://' only<br/>Disabled: if "[Use Provider](#firefox.dns_over_https.provider)" is not "Custom". \|
[tutorial v1.1_170] A leadership family (config and doc) 2026-04-18 21:49:06 +02:00
			`# FoxyProxy`

			`> [!NOTE]`
			`>`
			`> This family is a namespace.\`
			`> Path: foxyproxy\`
[tutorial v1.1_181] Calculate a random color (config and doc) 2026-04-18 21:49:15 +02:00			> `standard`
[tutorial v1.1_170] A leadership family (config and doc) 2026-04-18 21:49:06 +02:00
			`## Proxy configuration`

			`> [!NOTE]`
			`>`
			`> This family contains lists of variable blocks.\`
			`> Path: foxyproxy.proxies\`
[tutorial v1.1_181] Calculate a random color (config and doc) 2026-04-18 21:49:15 +02:00			> `standard`
[tutorial v1.1_170] A leadership family (config and doc) 2026-04-18 21:49:06 +02:00
[tutorial v1.1_181] Calculate a random color (config and doc) 2026-04-18 21:49:15 +02:00			`\| Variable \| Description \|`
			`\|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\|------------------------------------------------------------------------------------------------------------------------------\|`
			\| <a id="foxyproxy.proxies.title" name="foxyproxy.proxies.title">foxyproxy.proxies.title</a><br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `multiple` `standard` `unique` \| Title or Description. \|
			\| <a id="foxyproxy.proxies.color" name="foxyproxy.proxies.color">foxyproxy.proxies.color</a><br/>[`regexp`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` \| Color.<br/>Validator: text based with regular expressions "^#(?:[0-9a-f]{3}){1,2}$"<br/>Default: random color value. \|