FFmpeg Docker image
This project prepares a minimalist Docker image with FFmpeg. It compiles FFmpeg from sources following instructions from the Compilation Guide.
You can install the latest build of this image by running docker pull ghcr.io/jrottenberg/ffmpeg:${VERSION}-${VARIANT} or docker pull jrottenberg/ffmpeg:${VERSION}-${VARIANT}.
For the latest FFmpeg version on Ubuntu LTS, you can use: docker pull ghcr.io/jrottenberg/ffmpeg:latest or docker pull jrottenberg/ffmpeg:latest.
This image can be used as a base for an encoding farm.
Builds / Available Docker Containers
There are different builds available:
Below is a table that provides examples for the nomenclature:
ffmpeg-<version>-<os variant and version>
| image name |
OS ver |
ffmpeg ver |
arch |
variant |
description |
| ffmpeg-9.0-ubuntu2404 |
24.04 |
9.x |
amd64, arm64 |
ubuntu |
external libraries are installed from os packages, and ffmpeg is built from source. See Ubuntu Compilation Guide for details on this. |
| ffmpeg-9.0-ubuntu2404-edge |
24.04 |
9.x |
amd64, arm64 |
ubuntu |
libs and ffmpeg are built from source. See Ubuntu Compilation Guide for details on this. |
| ffmpeg-9.0-vaapi2404 |
24.04 |
9.x |
amd64 |
ubuntu |
like: ubuntu2404 but enables: Video Acceleration API (VAAPI) in ffmpeg |
| ffmpeg-9.0-nvidia2404 |
24.04 |
9.x |
amd64 |
ubuntu |
Built w/ NVIDIA’s hardware-accelerated encoding and decoding APIs enabled |
| ffmpeg-9.0-qsv2404 |
24.04 |
9.x |
amd64 |
ubuntu |
like: ubuntu2404 but enables: Intel Quick Sync Video ( QSV ) through oneVPL |
| ffmpeg-9.0-alpine320 |
3.20 |
9.x |
amd64, arm64 |
alpine |
vendor libs, but ffmpeg is built from source |
| ffmpeg-9.0-scratch320 |
3.20 |
9.x |
amd64, arm64 |
alpine |
vendor libs, and ffmpeg are built from source. Also we make the distro as small as possible by not installing any packages in base and striping symbols of installed libs |
ffmpeg <version> can be one of the following: 8.0, 8.1, 9.0 with the above table.
Note: The current versions of ffmpeg supported are anything newer than 3 years old and not exceeded the end-of-life
Here are some additional older builds
- alpine based images
ffmpeg:<version>-alpine or ffmpeg:<version>-alpine320 (old versions with ffmpeg:<version>-alpine313 , ffmpeg:<version>-alpine312)
- alpine based scratch images
ffmpeg:<version>-scratch or ffmpeg:<version>-scratch320 (old versions with ffmpeg:<version>-scratch313 , ffmpeg:<version>-scratch312)
- ubuntu based images
ffmpeg:<version>-ubuntu or ffmpeg:<version>-ubuntu2404 (old versions with ffmpeg:<version>-ubuntu2004 , ffmpeg:<version>-ubuntu1804)
- ubuntu based nvidia images
ffmpeg:<version>-nvidia or ffmpeg:<version>-nvidia2404 (old versions with ffmpeg:<version>-nvidia2204, ffmpeg:<version>-nvidia2004)
- ubuntu based vaapi images
ffmpeg:<version>-vaapi2404 (old versions with ffmpeg:<version>-vaapi2004, ffmpeg:<version>-vaapi1804)
- ubuntu based Intel Quick Sync Video images
ffmpeg:<version>-qsv or ffmpeg:<version>-qsv2404
Philosophy behind the different builds
ubuntu2404
We chose Ubuntu 24.04 because it is the LTS ( Long Term Support ) build of Ubuntu.
We used the ffmpeg support libraries from the Ubuntu distribution where possible. Example: we use ‘libx264-dev’ as the package to install. We do not tie it to a version. This way when its time to update from 24.04 to 26.04 we can simply update the base Docker template for ubuntu. This will make updating the OS easier as time goes on.
ubuntu2404-edge
This image is just like the above ubuntu2404 container image, except we build all of the ffmpeg support libraries. This is in the spirit of the original intent of this project jrottenberg/ffmpeg alltogether. Building everything that ffmpeg needs, and ffmpeg itself from source. This gives us the most control over all of the details of release. The drawback of this is that its much harder to keep updated. The thought process of having both ‘Ubuntu-2404’ and ‘Ubuntu-2404-edge’ is that it makes updating the OS easier over time.
vaapi2404
Based on ubuntu2404 with Video Acceleration API (VAAPI) enabled.
nvidia2404
Based on ubuntu2404 with NVIDIA’s hardware-accelerated encoding and decoding APIs enabled.
qsv2404
Based on ubuntu2404 with Intel Quick Sync Video ( QSV ) enabled through oneVPL ( --enable-libvpl ). The image ships the oneVPL dispatcher, the oneVPL GPU implementation ( mfx-gen ) and the Intel media driver ( iHD ), so no extra packages are needed inside the container. Note that oneVPL only supports Intel GPUs from Tiger Lake ( 11th gen ) and newer — on older GPUs ( Skylake, Kaby Lake, … ) the *_qsv codecs fail to initialise, use the vaapi variant there instead.
alpine320
alpine uses the os vendor libs, but ffmpeg is built from source.
scratch
Scratch is also an alpine image. We build the vendor libs, and ffmpeg from source. Also we make the distro as small as possible by not installing any packages in base and striping symbols of installed libs.
Generate list of recent Docker Container Images
You can use the following command to generate a list of current images:
$ python3 -mvenv .venv
$ source .venv/bin/activate
$ pip install requests
$ python3 ./generate-list-of-recent-images.py > list_of_recent_images.txt
$ deactivate
$ rm -rf .venv
$ less list_of_recent_images.txt
If you want to compare the one you have locally, use the following command:
$ docker images | grep ffmpeg | sort | awk '{print $1 ":" $2 "\t" $7 $8}'
Please use Github issues to report any bug or missing feature.
Test
ffmpeg version N-98740-ga72d529 Copyright (c) 2000-2020 the FFmpeg developers
built with gcc 7 (Ubuntu 7.5.0-3ubuntu1~18.04)
configuration: --disable-debug --disable-doc --disable-ffplay --enable-shared --enable-avresample --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-gpl --enable-libass --enable-fontconfig --enable-libfreetype --enable-libvidstab --enable-libmp3lame --enable-libopus --enable-libtheora --enable-libvorbis --enable-libvpx --enable-libwebp --enable-libxcb --enable-libx265 --enable-libxvid --enable-libx264 --enable-nonfree --enable-openssl --enable-libfdk_aac --enable-postproc --enable-small --enable-version3 --enable-libbluray --enable-libzmq --extra-libs=-ldl --prefix=/opt/ffmpeg --enable-libopenjpeg --enable-libkvazaar --enable-libaom --extra-libs=-lpthread --enable-libsrt --enable-libaribb24 --enable-vaapi --extra-cflags=-I/opt/ffmpeg/include --extra-ldflags=-L/opt/ffmpeg/lib
libavutil 56. 58.100 / 56. 58.100
libavcodec 58.100.100 / 58.100.100
libavformat 58. 51.100 / 58. 51.100
libavdevice 58. 11.101 / 58. 11.101
libavfilter 7. 87.100 / 7. 87.100
libavresample 4. 0. 0 / 4. 0. 0
libswscale 5. 8.100 / 5. 8.100
libswresample 3. 8.100 / 3. 8.100
libpostproc 55. 8.100 / 55. 8.100
configuration:
--disable-debug
--disable-doc
--disable-ffplay
--enable-shared
--enable-avresample
--enable-libopencore-amrnb
--enable-libopencore-amrwb
--enable-gpl
--enable-libass
--enable-fontconfig
--enable-libfreetype
--enable-libvidstab
--enable-libmp3lame
--enable-libopus
--enable-libtheora
--enable-libvorbis
--enable-libvpx
--enable-libwebp
--enable-libxcb
--enable-libx265
--enable-libxvid
--enable-libx264
--enable-nonfree
--enable-openssl
--enable-libfdk_aac
--enable-postproc
--enable-small
--enable-version3
--enable-libbluray
--enable-libzmq
--extra-libs=-ldl
--prefix=/opt/ffmpeg
--enable-libopenjpeg
--enable-libkvazaar
--enable-libaom
--extra-libs=-lpthread
--enable-libsrt
--enable-libaribb24
--enable-vaapi
--extra-cflags=-I/opt/ffmpeg/include
--extra-ldflags=-L/opt/ffmpeg/lib
Capture output from the container to the host running the command
docker run jrottenberg/ffmpeg:4.4-alpine \
-i http://url/to/media.mp4 \
-stats \
$ffmpeg_options - > out.mp4
Examples
docker run jrottenberg/ffmpeg:4.4-alpine -stats \
-i http://archive.org/download/thethreeagesbusterkeaton/Buster.Keaton.The.Three.Ages.ogv \
-loop 0 \
-final_delay 500 -c:v gif -f gif -ss 00:49:42 -t 5 - > trow_ball.gif
Convert 10bits MKV into a 10Bits MP4
docker run -v $(pwd):$(pwd) -w $(pwd) jrottenberg/ffmpeg:4.4-scratch \
-stats \
-i http://www.jell.yfish.us/media/jellyfish-20-mbps-hd-hevc-10bit.mkv \
-c:v libx265 -pix_fmt yuv420p10 \
-t 5 -f mp4 test.mp4
The image has been compiled with X265 Multilib.
Use the pixel format switch to change the number of bits per pixel by suffixing it with 10 for 10bits or 12 for 12bits.
Convert a local GIF into a mp4
Let’s assume original.gif is located in the current directory :
docker run -v $(pwd):$(pwd) -w $(pwd)\
jrottenberg/ffmpeg:4.4-scratch -stats \
-i original.gif \
original-converted.mp4
Use ZeroMQ to toggle filter value on-fly
Let’s start some process continuously writing some radio music, and listen it:
docker run --rm -d -v $(pwd):$(pwd) -w $(pwd) -p 11235:11235 \
--name radio-writer jrottenberg/ffmpeg:4.4-alpine \
-i http://radio.casse-tete.solutions/salut-radio-64.mp3 \
-filter_complex '[0:a]volume@vol=1,azmq=bind_address=tcp\\\://0.0.0.0\\\:11235[out]' \
-map '[out]' ./salut-radio.mp3
docker run -it -v $(pwd):$(pwd) -w $(pwd) --entrypoint=ffprobe jrottenberg/ffmpeg:4.4-alpine -v quiet -show_streams salut-radio.mp3
Now, just toggle its volume on-fly, and hear how it changes:
docker run --rm --network=host --entrypoint sh jrottenberg/ffmpeg:4.4-ubuntu -c \
'echo "volume@vol volume 2" | zmqsend -b tcp://127.0.0.1:11235'
Send a stream over SRT
Let’s send video.mp4 to srt-listener on port 9000 over SRT protocol.
docker run -v $(pwd):$(pwd) jrottenberg/ffmpeg:4.4-centos \
-re -i $(pwd)/video.mp4 -acodec copy -vcodec copy -f mpegts srt://srt-listener:9000?pkt_size=1316
Use hardware acceleration enabled build
Thanks to qmfrederik for the vaapi ubuntu based variant
jrottenberg/ffmpeg:vaapi or jrottenberg/ffmpeg:${VERSION}-vaapi
- Run the container with the device attached /dev/dri from your host into the container :
docker run --device /dev/dri:/dev/dri -v $(pwd):$(pwd) -w $(pwd) jrottenberg/ffmpeg:4.4-vaapi [...]
- Have the Intel drivers up and running on your host. You can run
vainfo (part of vainfo package on Ubuntu) to determine whether your graphics card has been recognized correctly.
- Run ffmpeg with the correct parameters, this is the same as when running ffmpeg natively.
Use nvidia hardware acceleration enabled build
Thanks to ShaulMyplay for the nvidia based variant
Supports nvenc only on all ffmpeg versions, and hardware decoding and scaling on ffmpeg >= 4.0
Hardware encoding only example:
docker run --runtime=nvidia jrottenberg/ffmpeg:4.4-nvidia -i INPUT -c:v nvenc_h264 -preset hq OUTPUT
Full hardware acceleration example:
docker run --runtime=nvidia jrottenberg/ffmpeg:4.4-nvidia -hwaccel cuvid -c:v h264_cuvid -i INPUT -vf scale_npp=-1:720 -c:v h264_nvenc -preset slow OUTPUT
Use Intel Quick Sync Video ( QSV ) enabled build
jrottenberg/ffmpeg:${VERSION}-qsv or jrottenberg/ffmpeg:${VERSION}-qsv2404 ( example: jrottenberg/ffmpeg:9.0-qsv )
- The container has oneVPL, the oneVPL GPU implementation and the Intel media ( iHD ) driver installed, the host only needs an Intel GPU with its kernel driver loaded. oneVPL supports Tiger Lake ( 11th gen ) and newer Intel GPUs — on older GPUs use the
vaapi variant instead.
- Run the container with the device attached /dev/dri from your host into the container:
docker run --device /dev/dri:/dev/dri -v $(pwd):$(pwd) -w $(pwd) jrottenberg/ffmpeg:9.0-qsv [...]
Hardware encoding only example ( software decode, QSV encode ):
docker run --device /dev/dri:/dev/dri jrottenberg/ffmpeg:9.0-qsv -i INPUT -c:v h264_qsv -quality auto -b:v 5M OUTPUT
Full hardware acceleration example ( QSV decode and encode ):
docker run --device /dev/dri:/dev/dri jrottenberg/ffmpeg:9.0-qsv -c:v h264_qsv -i INPUT -c:v h264_qsv -quality auto OUTPUT
- Run ffmpeg with the correct parameters, this is the same as when running ffmpeg natively. QSV is used through the
*_qsv decoders and encoders ( -c:v h264_qsv, -c:v hevc_qsv, -c:v av1_qsv, … ), FFmpeg has no -hwaccel qsv option.
See what’s inside the beast
docker run -it --entrypoint='bash' jrottenberg/ffmpeg:7.1-ubuntu2404
for i in ogg amr vorbis theora mp3lame opus vpx xvid fdk x264 x265;do echo $i; find /usr/local/ -name *$i*;done
Libs are in /lib in alpine.
docker run -it --entrypoint='sh' jrottenberg/ffmpeg:7.1-alpine320
for i in ogg amr vorbis theora mp3lame opus vpx xvid fdk x264 x265;do echo $i; find /lib/ -name *$i*;done
FFMPEG Supported Libraries
The following libraries are used by FFMPEG. The version number and release date are provided along with the license information.
These version numbers are for the lib source builds, which are ‘ubuntu2404-edge’ and ‘scratch320’.
These libs are included in the package images as well, but the version numbers might vary slightly.
Contribute
See the contributing guide
Legal
Those docker images use code of FFmpeg licensed under the LGPLv2.1 and their source can be downloaded on github.com/jrottenberg/ffmpeg.
![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)
评论