mirror of
https://github.com/woodchen-ink/docker-firefox.git
synced 2025-07-18 13:52:02 +08:00
129 lines
4.8 KiB
XML
129 lines
4.8 KiB
XML
<!--
|
|
Definitions for Firefox docker container.
|
|
|
|
This file is used as data source to generate README.md and unRAID template files
|
|
from Jinja2 templates.
|
|
-->
|
|
<defs>
|
|
<app>
|
|
<id>14</id>
|
|
<gui>True</gui>
|
|
<friendly_name>Firefox</friendly_name>
|
|
<name>{{ defs.app.friendly_name|lower|replace(' ', '-') }}</name>
|
|
<project>
|
|
<description>Mozilla Firefox is a free and open-source web browser developed by Mozilla Foundation and its subsidiary, Mozilla Corporation.</description>
|
|
<url>https://www.mozilla.org/en-US/firefox/</url>
|
|
</project>
|
|
<unraid>
|
|
<support_url>https://forums.lime-technology.com/topic/69440-support-firefox/</support_url>
|
|
<category>Tools:</category>
|
|
</unraid>
|
|
<container>
|
|
<rough_download_size>150MB</rough_download_size>
|
|
<unsupported_volume>/storage</unsupported_volume>
|
|
</container>
|
|
<!-- Extra stuff to be added to the documentation. -->
|
|
<documentation>
|
|
<section>
|
|
<title level="2">Increasing Shared Memory Size</title>
|
|
<content>
|
|
To prevent crashes from happening when running {{ defs.app.friendly_name }}
|
|
inside a Docker container, the size of the shared memory located at `/dev/shm`
|
|
must be increased. The issue is documented [here].
|
|
|
|
By default, the size is 64MB, which is not enough. It is recommended to use a
|
|
size of 2GB. This value is arbitrary, but known to work well. Setting the
|
|
size of `/dev/shm` can be done via two method:
|
|
|
|
- By adding the `--shm-size 2g` parameter to the `docker run` command. See
|
|
the [Usage](#usage) section for more details.
|
|
- By using shared memory of the host, by mapping `/dev/shm` via the parameter
|
|
`-v /dev/shm:/dev/shm` of the `docker run` command.
|
|
</content>
|
|
</section>
|
|
<section>
|
|
<title level="2">Sound Support</title>
|
|
<content>
|
|
For {{ defs.app.friendly_name }} to be able to use the audio device available on
|
|
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">Troubleshooting</title>
|
|
<content/>
|
|
</section>
|
|
<section>
|
|
<title level="3">Crashes</title>
|
|
<content>
|
|
If {{ defs.app.friendly_name }} is crashing frequently, make sure the size of
|
|
the shared memory located at `/dev/shm` has been increased. See
|
|
[Increasing Shared Memory Size](#increasing-shared-memory-size) section for more
|
|
details.
|
|
</content>
|
|
</section>
|
|
<link>
|
|
<name>here</name>
|
|
<url>https://bugzilla.mozilla.org/show_bug.cgi?id=1338771#c10</url>
|
|
</link>
|
|
</documentation>
|
|
<!-- Changelog of the application. -->
|
|
<history>
|
|
<release>
|
|
<version>1.2.0</version>
|
|
<date>2018-07-12</date>
|
|
<change>Now using baseimage v3.4.0, which is based on Alpine Linux 3.8.</change>
|
|
<change>Upgraded Firefox to version 61.0.1-r0.</change>
|
|
</release>
|
|
<release>
|
|
<version>1.1.0</version>
|
|
<date>2018-05-31</date>
|
|
<change>Upgraded Firefox to version 60.0.1-r0.</change>
|
|
</release>
|
|
<release>
|
|
<version>1.0.2</version>
|
|
<date>2018-03-15</date>
|
|
<change>Fixed issue where Firefox would not gracefully terminate.</change>
|
|
<change>Fixed an issue where restoring session would resize window to the wrong dimensions.</change>
|
|
</release>
|
|
<release>
|
|
<version>1.0.1</version>
|
|
<date>2018-03-02</date>
|
|
<change>Now using baseimage v3.3.4, which brings the following changes:</change>
|
|
<change level="2">Fixed issue where log monitor states were not cleared during container startup.</change>
|
|
<change>Updated Firefox to version 58.0.1-r2.</change>
|
|
</release>
|
|
<release>
|
|
<version>1.0.0</version>
|
|
<date>2018-02-16</date>
|
|
<change>Initial release.</change>
|
|
</release>
|
|
</history>
|
|
</app>
|
|
<container>
|
|
<!-- Environment variables -->
|
|
<environment_variables/>
|
|
<!-- Volumes -->
|
|
<volumes/>
|
|
<!-- Network ports -->
|
|
<ports/>
|
|
<!-- Devices -->
|
|
<devices>
|
|
<device>
|
|
<path>/dev/snd</path>
|
|
<description>Optional Linux device to expose to have sound.</description>
|
|
<include_in_quick_start>false</include_in_quick_start>
|
|
</device>
|
|
</devices>
|
|
<!-- Extra parameters -->
|
|
<extra_params>
|
|
<extra_param>
|
|
<name>shm-size</name>
|
|
<value>2g</value>
|
|
<description>Set the size of `/dev/shm` to `VALUE`. The format of `VALUE` is `<number><unit>`, where `number` must be greater than `0` and `unit` can be `b` (bytes), `k` (kilobytes), `m` (megabytes), or `g` (gigabytes). **NOTE**: To avoid crashes, it is recommended to set this value to `2g`.</description>
|
|
<include_in_quick_start>true</include_in_quick_start>
|
|
</extra_param>
|
|
</extra_params>
|
|
</container>
|
|
</defs>
|