docker-documentation/docs/images/docker-firefox.md

426 wiersze
17 KiB
Markdown
Czysty Zwykły widok Historia

2021-04-19 20:21:23 +00:00
---
title: firefox
2025-02-01 20:34:55 +00:00
tags:
- Web Browser
description: "[Firefox](https://www.mozilla.org/en-US/firefox/) Browser, also known as Mozilla Firefox or simply Firefox, is a free and open-source web browser developed by the Mozilla Foundation and its subsidiary, the Mozilla Corporation. Firefox uses the Gecko layout engine to render web pages, which implements current and anticipated web standards."
2021-04-19 20:21:23 +00:00
---
2023-10-07 20:30:31 +00:00
<!-- DO NOT EDIT THIS FILE MANUALLY -->
<!-- Please read https://github.com/linuxserver/docker-firefox/blob/master/.github/CONTRIBUTING.md -->
2021-04-19 20:21:23 +00:00
# [linuxserver/firefox](https://github.com/linuxserver/docker-firefox)
2024-05-23 15:27:56 +00:00
[![Scarf.io pulls](https://scarf.sh/installs-badge/linuxserver-ci/linuxserver%2Ffirefox?color=94398d&label-color=555555&logo-color=ffffff&style=for-the-badge&package-type=docker)](https://scarf.sh)
2021-04-19 20:21:23 +00:00
[![GitHub Stars](https://img.shields.io/github/stars/linuxserver/docker-firefox.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&logo=github)](https://github.com/linuxserver/docker-firefox)
[![GitHub Release](https://img.shields.io/github/release/linuxserver/docker-firefox.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&logo=github)](https://github.com/linuxserver/docker-firefox/releases)
[![GitHub Package Repository](https://img.shields.io/static/v1.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=linuxserver.io&message=GitHub%20Package&logo=github)](https://github.com/linuxserver/docker-firefox/packages)
[![GitLab Container Registry](https://img.shields.io/static/v1.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=linuxserver.io&message=GitLab%20Registry&logo=gitlab)](https://gitlab.com/linuxserver.io/docker-firefox/container_registry)
2021-10-03 06:02:03 +00:00
[![Quay.io](https://img.shields.io/static/v1.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=linuxserver.io&message=Quay.io)](https://quay.io/repository/linuxserver.io/firefox)
2021-04-19 20:21:23 +00:00
[![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/firefox.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=pulls&logo=docker)](https://hub.docker.com/r/linuxserver/firefox)
[![Docker Stars](https://img.shields.io/docker/stars/linuxserver/firefox.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=stars&logo=docker)](https://hub.docker.com/r/linuxserver/firefox)
[![Jenkins Build](https://img.shields.io/jenkins/build?labelColor=555555&logoColor=ffffff&style=for-the-badge&jobUrl=https%3A%2F%2Fci.linuxserver.io%2Fjob%2FDocker-Pipeline-Builders%2Fjob%2Fdocker-firefox%2Fjob%2Fmaster%2F&logo=jenkins)](https://ci.linuxserver.io/job/Docker-Pipeline-Builders/job/docker-firefox/job/master/)
[![LSIO CI](https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=CI&query=CI&url=https%3A%2F%2Fci-tests.linuxserver.io%2Flinuxserver%2Ffirefox%2Flatest%2Fci-status.yml)](https://ci-tests.linuxserver.io/linuxserver/firefox/latest/index.html)
[Firefox](https://www.mozilla.org/en-US/firefox/) Browser, also known as Mozilla Firefox or simply Firefox, is a free and open-source web browser developed by the Mozilla Foundation and its subsidiary, the Mozilla Corporation. Firefox uses the Gecko layout engine to render web pages, which implements current and anticipated web standards.
2023-10-07 20:30:31 +00:00
[![firefox](https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/firefox-logo.png)](https://www.mozilla.org/en-US/firefox/)
2021-04-19 20:21:23 +00:00
## Supported Architectures
2023-11-18 20:28:20 +00:00
We utilise the docker manifest for multi-platform awareness. More information is available from docker [here](https://distribution.github.io/distribution/spec/manifest-v2-2/#manifest-list) and our announcement [here](https://blog.linuxserver.io/2019/02/21/the-lsio-pipeline-project/).
2021-04-19 20:21:23 +00:00
2022-05-01 06:02:12 +00:00
Simply pulling `lscr.io/linuxserver/firefox:latest` should retrieve the correct image for your arch, but you can also pull specific arch images via tags.
2021-04-19 20:21:23 +00:00
The architectures supported by this image are:
2022-05-01 06:02:12 +00:00
| Architecture | Available | Tag |
| :----: | :----: | ---- |
| x86-64 | ✅ | amd64-\<version tag\> |
| arm64 | ✅ | arm64v8-\<version tag\> |
2021-04-19 20:21:23 +00:00
2025-07-01 14:22:38 +00:00
## Version Tags
This image provides various versions that are available via tags. Please read the descriptions carefully and exercise caution when using unstable or development tags.
| Tag | Available | Description |
| :----: | :----: |--- |
| latest | ✅ | Latest releases using the selkies base |
| kasm | ✅ | Latest releases using the kasmvnc base |
2021-04-19 20:21:23 +00:00
## Application Setup
The application can be accessed at:
2023-04-07 21:56:18 +00:00
* https://yourhost:3001/
2021-04-19 20:21:23 +00:00
2024-11-09 21:09:04 +00:00
### Security
2025-06-26 19:27:06 +00:00
>[!WARNING]
>Do not put this on the Internet if you do not know what you are doing.
2024-11-09 21:09:04 +00:00
By default this container has no authentication and the optional environment variables `CUSTOM_USER` and `PASSWORD` to enable basic http auth via the embedded NGINX server should only be used to locally secure the container from unwanted access on a local network. If exposing this to the Internet we recommend putting it behind a reverse proxy, such as [SWAG](https://github.com/linuxserver/docker-swag), and ensuring a secure authentication solution is in place. From the web interface a terminal can be launched and it is configured for passwordless sudo, so anyone with access to it can install and run whatever they want along with probing your local network.
2025-06-26 19:27:06 +00:00
### Nvidia GPU Support
2024-09-26 04:46:13 +00:00
2024-11-09 21:09:04 +00:00
**Nvidia support is not compatible with Alpine based images as Alpine lacks Nvidia drivers**
2024-09-26 04:46:13 +00:00
Nvidia support is available by leveraging Zink for OpenGL support. This can be enabled with the following run flags:
| Variable | Description |
| :----: | --- |
| --gpus all | This can be filtered down but for most setups this will pass the one Nvidia GPU on the system |
| --runtime nvidia | Specify the Nvidia runtime which mounts drivers and tools in from the host |
The compose syntax is slightly different for this as you will need to set nvidia as the default runtime:
```
sudo nvidia-ctk runtime configure --runtime=docker --set-as-default
sudo service docker restart
```
And to assign the GPU in compose:
```
services:
firefox:
2024-11-09 21:09:04 +00:00
image: lscr.io/linuxserver/firefox:latest
2024-09-26 04:46:13 +00:00
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: 1
capabilities: [compute,video,graphics,utility]
```
2025-06-26 19:27:06 +00:00
### Strict reverse proxies
2024-11-09 21:09:04 +00:00
2025-06-26 19:27:06 +00:00
This image uses a self-signed certificate by default. This naturally means the scheme is `https`.
If you are using a reverse proxy which validates certificates, you need to [disable this check for the container](https://docs.linuxserver.io/faq#strict-proxy).
2024-11-09 21:09:04 +00:00
2021-04-19 20:21:23 +00:00
## Usage
2021-07-04 06:03:05 +00:00
To help you get started creating a container from this image you can either use docker-compose or the docker cli.
2021-04-19 20:21:23 +00:00
2024-12-07 20:37:24 +00:00
!!! info
Unless a parameter is flaged as 'optional', it is *mandatory* and a value must be provided.
2021-07-04 06:03:05 +00:00
### docker-compose (recommended, [click here for more info](https://docs.linuxserver.io/general/docker-compose))
2021-04-19 20:21:23 +00:00
```yaml
---
services:
firefox:
2022-05-01 06:02:12 +00:00
image: lscr.io/linuxserver/firefox:latest
2021-04-19 20:21:23 +00:00
container_name: firefox
2022-10-23 17:58:37 +00:00
security_opt:
- seccomp:unconfined #optional
2021-04-19 20:21:23 +00:00
environment:
- PUID=1000
- PGID=1000
2023-02-12 06:01:48 +00:00
- TZ=Etc/UTC
2024-02-13 23:39:32 +00:00
- FIREFOX_CLI=https://www.linuxserver.io/ #optional
2021-04-19 20:21:23 +00:00
volumes:
2025-07-01 14:22:38 +00:00
- /path/to/firefox/config:/config
2021-04-19 20:21:23 +00:00
ports:
- 3000:3000
2023-04-07 21:56:18 +00:00
- 3001:3001
2021-04-19 20:21:23 +00:00
shm_size: "1gb"
restart: unless-stopped
```
2021-07-04 06:03:05 +00:00
### docker cli ([click here for more info](https://docs.docker.com/engine/reference/commandline/cli/))
2021-04-19 20:21:23 +00:00
```bash
docker run -d \
--name=firefox \
2022-10-23 17:58:37 +00:00
--security-opt seccomp=unconfined `#optional` \
2021-04-19 20:21:23 +00:00
-e PUID=1000 \
-e PGID=1000 \
2023-02-12 06:01:48 +00:00
-e TZ=Etc/UTC \
2024-02-13 23:39:32 +00:00
-e FIREFOX_CLI=https://www.linuxserver.io/ `#optional` \
2021-04-19 20:21:23 +00:00
-p 3000:3000 \
2023-04-07 21:56:18 +00:00
-p 3001:3001 \
2025-07-01 14:22:38 +00:00
-v /path/to/firefox/config:/config \
2021-04-19 20:21:23 +00:00
--shm-size="1gb" \
--restart unless-stopped \
2022-05-01 06:02:12 +00:00
lscr.io/linuxserver/firefox:latest
2021-04-19 20:21:23 +00:00
```
## Parameters
2023-10-07 20:30:31 +00:00
Containers are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `<external>:<internal>` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.
2021-04-19 20:21:23 +00:00
### Ports (`-p`)
| Parameter | Function |
| :----: | --- |
2024-12-07 20:37:24 +00:00
| `3000:3000` | Firefox desktop gui. |
| `3001:3001` | Firefox desktop gui HTTPS. |
2021-04-19 20:21:23 +00:00
### Environment Variables (`-e`)
| Env | Function |
| :----: | --- |
| `PUID=1000` | for UserID - see below for explanation |
| `PGID=1000` | for GroupID - see below for explanation |
2023-02-12 06:01:48 +00:00
| `TZ=Etc/UTC` | specify a timezone to use, see this [list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List). |
2024-02-13 23:39:32 +00:00
| `FIREFOX_CLI=https://www.linuxserver.io/` | Specify one or multiple Firefox CLI flags, this string will be passed to the application in full. |
2021-04-19 20:21:23 +00:00
### Volume Mappings (`-v`)
| Volume | Function |
| :----: | --- |
| `/config` | Users home directory in the container, stores local files and settings |
#### Miscellaneous Options
| Parameter | Function |
| :-----: | --- |
| `--shm-size=` | This is needed for any modern website to function like youtube. |
2022-10-23 17:58:37 +00:00
| `--security-opt seccomp=unconfined` | For Docker Engine only, many modern gui apps need this to function on older hosts as syscalls are unknown to Docker. |
2021-04-19 20:21:23 +00:00
## Environment variables from files (Docker secrets)
You can set any environment variable from a file by using a special prepend `FILE__`.
As an example:
```bash
2023-10-07 20:30:31 +00:00
-e FILE__MYVAR=/run/secrets/mysecretvariable
2021-04-19 20:21:23 +00:00
```
2023-10-07 20:30:31 +00:00
Will set the environment variable `MYVAR` based on the contents of the `/run/secrets/mysecretvariable` file.
2021-04-19 20:21:23 +00:00
## Umask for running applications
For all of our images we provide the ability to override the default umask settings for services started within the containers using the optional `-e UMASK=022` setting.
Keep in mind umask is not chmod it subtracts from permissions based on it's value it does not add. Please read up [here](https://en.wikipedia.org/wiki/Umask) before asking for support.
## User / Group Identifiers
When using volumes (`-v` flags), permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user `PUID` and group `PGID`.
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
2023-10-07 20:30:31 +00:00
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id your_user` as below:
2021-04-19 20:21:23 +00:00
```bash
2023-10-07 20:30:31 +00:00
id your_user
```
Example output:
```text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
2021-04-19 20:21:23 +00:00
```
## Docker Mods
[![Docker Mods](https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=firefox&query=%24.mods%5B%27firefox%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml)](https://mods.linuxserver.io/?mod=firefox "view available mods for this container.") [![Docker Universal Mods](https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml)](https://mods.linuxserver.io/?mod=universal "view available universal mods.")
We publish various [Docker Mods](https://github.com/linuxserver/docker-mods) to enable additional functionality within the containers. The list of Mods available for this image (if any) as well as universal mods that can be applied to any one of our images can be accessed via the dynamic badges above.
## Support Info
* Shell access whilst the container is running:
2023-10-07 20:30:31 +00:00
```bash
docker exec -it firefox /bin/bash
```
2021-04-19 20:21:23 +00:00
* To monitor the logs of the container in realtime:
2023-10-07 20:30:31 +00:00
```bash
docker logs -f firefox
```
* Container version number:
```bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' firefox
```
* Image version number:
```bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/firefox:latest
```
## Updating Info
2024-01-13 20:28:57 +00:00
Most of our images are static, versioned, and require an image update and container recreation to update the app inside. With some exceptions (noted in the relevant readme.md), we do not recommend or support updating apps inside the container. Please consult the [Application Setup](#application-setup) section above to see if it is recommended for the image.
2023-10-07 20:30:31 +00:00
Below are the instructions for updating containers:
### Via Docker Compose
* Update images:
* All images:
```bash
docker-compose pull
```
* Single image:
```bash
docker-compose pull firefox
```
* Update containers:
* All containers:
```bash
docker-compose up -d
```
* Single container:
```bash
docker-compose up -d firefox
```
* You can also remove the old dangling images:
```bash
docker image prune
```
### Via Docker Run
* Update the image:
```bash
docker pull lscr.io/linuxserver/firefox:latest
```
* Stop the running container:
```bash
docker stop firefox
```
* Delete the container:
```bash
docker rm firefox
```
* Recreate a new container with the same docker run parameters as instructed above (if mapped correctly to a host folder, your `/config` folder and settings will be preserved)
* You can also remove the old dangling images:
```bash
docker image prune
```
### Image Update Notifications - Diun (Docker Image Update Notifier)
2024-09-28 20:36:46 +00:00
!!! tip
2023-10-07 20:30:31 +00:00
We recommend [Diun](https://crazymax.dev/diun/) for update notifications. Other tools that automatically update containers unattended are not recommended or supported.
## Building locally
If you want to make local modifications to these images for development purposes or just to customize the logic:
```bash
git clone https://github.com/linuxserver/docker-firefox.git
cd docker-firefox
docker build \
--no-cache \
--pull \
-t lscr.io/linuxserver/firefox:latest .
```
2024-11-09 20:34:18 +00:00
The ARM variants can be built on x86_64 hardware and vice versa using `lscr.io/linuxserver/qemu-static`
2023-10-07 20:30:31 +00:00
```bash
2024-11-09 20:34:18 +00:00
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
2023-10-07 20:30:31 +00:00
```
Once registered you can define the dockerfile to use with `-f Dockerfile.aarch64`.
2021-04-19 20:21:23 +00:00
2024-12-16 10:39:37 +00:00
To help with development, we generate this dependency graph.
??? info "Init dependency graph"
```d2
"firefox:latest": {
docker-mods
base {
fix-attr +\nlegacy cont-init
}
docker-mods -> base
legacy-services
custom services
init-services -> legacy-services
init-services -> custom services
custom services -> legacy-services
legacy-services -> ci-service-check
init-migrations -> init-adduser
init-os-end -> init-config
2025-06-26 19:27:06 +00:00
init-selkies-end -> init-config
2024-12-16 10:39:37 +00:00
init-config -> init-config-end
init-crontab-config -> init-config-end
init-config -> init-crontab-config
init-mods-end -> init-custom-files
2025-05-17 20:36:44 +00:00
init-adduser -> init-device-perms
2024-12-16 10:39:37 +00:00
base -> init-envfile
base -> init-migrations
init-config-end -> init-mods
init-mods-package-install -> init-mods-end
init-mods -> init-mods-package-install
2025-06-26 19:27:06 +00:00
init-selkies -> init-nginx
2024-12-16 10:39:37 +00:00
init-adduser -> init-os-end
2025-05-17 20:36:44 +00:00
init-device-perms -> init-os-end
2024-12-16 10:39:37 +00:00
init-envfile -> init-os-end
2025-06-26 19:27:06 +00:00
init-os-end -> init-selkies
init-nginx -> init-selkies-config
init-video -> init-selkies-end
2024-12-16 10:39:37 +00:00
init-custom-files -> init-services
2025-06-26 19:27:06 +00:00
init-selkies-config -> init-video
2024-12-16 10:39:37 +00:00
init-services -> svc-cron
svc-cron -> legacy-services
init-services -> svc-de
svc-nginx -> svc-de
2025-06-26 19:27:06 +00:00
svc-selkies -> svc-de
svc-xorg -> svc-de
2024-12-16 10:39:37 +00:00
svc-de -> legacy-services
init-services -> svc-docker
svc-de -> svc-docker
svc-docker -> legacy-services
init-services -> svc-nginx
svc-nginx -> legacy-services
init-services -> svc-pulseaudio
svc-pulseaudio -> legacy-services
2025-06-26 19:27:06 +00:00
init-services -> svc-selkies
svc-nginx -> svc-selkies
svc-pulseaudio -> svc-selkies
svc-xorg -> svc-selkies
svc-selkies -> legacy-services
init-services -> svc-xorg
svc-xorg -> legacy-services
2024-12-16 10:39:37 +00:00
}
Base Images: {
2025-06-26 19:27:06 +00:00
"baseimage-selkies:ubuntunoble" <- "baseimage-ubuntu:noble"
2024-12-16 10:39:37 +00:00
}
"firefox:latest" <- Base Images
```
2021-04-19 20:21:23 +00:00
## Versions
2025-07-01 14:22:38 +00:00
* **01.07.25:** - Add Kasm branch.
2025-06-26 19:27:06 +00:00
* **23.06.25:** - Rebase to Selkies.
2024-09-26 04:46:13 +00:00
* **25.09.24:** - Rebase to Ubuntu Noble.
2024-05-23 15:27:56 +00:00
* **23.05.24:** - Rebase to Alpine 3.20.
2024-02-13 23:39:32 +00:00
* **13.02.24:** - Add ability to pass CLI args to Firefox.
2024-02-11 01:10:15 +00:00
* **10.02.24:** - Update Readme with new env vars and ingest proper PWA icon.
2024-01-02 19:36:58 +00:00
* **01.01.24:** - Rebase to Alpine 3.19.
2023-05-14 15:39:24 +00:00
* **13.05.23:** - Rebase to Alpine 3.18.
2023-04-07 21:56:18 +00:00
* **18.03.23:** - Rebase to KasmVNC base image.
2022-10-23 17:58:37 +00:00
* **21.10.22:** - Rebase to Alpine 3.16, migrate to s6v3.
2021-12-23 17:56:22 +00:00
* **23.12.21:** - Rebase to Alpine 3.15, stop using ESR.
2021-09-26 14:37:22 +00:00
* **26.09.21:** - Rebase to Alpine 3.14.
2021-04-19 20:21:23 +00:00
* **19.04.21:** - Initial release.