https://github.com/ragedunicorn/docker-ffmpeg
Repository for Docker ffmpeg image based on Alpine
https://github.com/ragedunicorn/docker-ffmpeg
alpine alpine-linux docker docker-container docker-image ffmpeg
Last synced: 5 months ago
JSON representation
Repository for Docker ffmpeg image based on Alpine
- Host: GitHub
- URL: https://github.com/ragedunicorn/docker-ffmpeg
- Owner: RagedUnicorn
- License: mit
- Created: 2025-07-12T09:15:19.000Z (12 months ago)
- Default Branch: master
- Last Pushed: 2026-01-16T19:31:44.000Z (5 months ago)
- Last Synced: 2026-01-17T07:22:59.401Z (5 months ago)
- Topics: alpine, alpine-linux, docker, docker-container, docker-image, ffmpeg
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/ragedunicorn/ffmpeg
- Size: 161 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# docker-ffmpeg
[](https://github.com/RagedUnicorn/docker-ffmpeg/actions/workflows/docker_release.yml)
[](https://github.com/RagedUnicorn/docker-ffmpeg/actions/workflows/test.yml)
> Docker Alpine image with FFmpeg and its dependencies.
## Overview
This Docker image provides a lightweight FFmpeg installation built from source on Alpine Linux. It includes a comprehensive set of codecs and libraries for versatile media processing capabilities.
## Features
- **Small footprint**: ~70-80MB runtime image using Alpine Linux
- **FFmpeg 7.1.1**: Latest stable version compiled from source
- **Extensive codec support**: x264, x265, VP9, Opus, MP3, AAC, and more
- **Multi-stage build**: Optimized for minimal final image size
- **Volume mounting**: Easy file input/output through `/tmp/workdir`
## Supported Codecs
### Video Codecs
- H.264 (libx264)
- H.265/HEVC (libx265)
- VP8/VP9 (libvpx)
- Theora (libtheora)
### Audio Codecs
- AAC (libfdk-aac)
- MP3 (libmp3lame)
- Opus (libopus)
- Vorbis (libvorbis)
### Additional Features
- Subtitles (libass)
- Text rendering (libfreetype)
- WebP support (libwebp)
- RTMP streaming (librtmp)
- SSL/TLS support (openssl)
## Quick Start
```bash
# Pull the image
docker pull ragedunicorn/ffmpeg:latest
# Run FFmpeg
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest -i input.mp4 output.mp4
```
For development and building from source, see [DEVELOPMENT.md](DEVELOPMENT.md).
## Usage
The container uses FFmpeg as the entrypoint, so any FFmpeg parameters can be passed directly to the `docker run` command.
### Basic Usage
```bash
# Using latest version
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest [ffmpeg-options]
# Using specific FFmpeg version (latest Alpine build)
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:7.1.1 [ffmpeg-options]
# Using exact version combination
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:7.1.1-alpine3.22.0-1 [ffmpeg-options]
```
### Examples
#### Convert Video Format
```bash
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest -i input.mp4 -c:v libx264 -c:a aac output.mp4
```
#### Get Video Information
```bash
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest -i input.mp4
```
#### Extract Audio
```bash
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest -i input.mp4 -vn -acodec mp3 output.mp3
```
#### Resize Video
```bash
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest -i input.mp4 -vf scale=1280:720 output.mp4
```
#### Convert to WebM
```bash
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest -i input.mp4 -c:v libvpx -c:a libvorbis output.webm
```
#### Create GIF from Video
```bash
docker run -v $(pwd):/tmp/workdir ragedunicorn/ffmpeg:latest -i input.mp4 -vf "fps=10,scale=320:-1" output.gif
```
## Docker Compose Usage
This repository includes Docker Compose configurations for easier usage and common media processing workflows.
### Basic Setup
1. Create a `media` directory structure:
```bash
mkdir -p media/input media/output
```
2. Place your input files in `media/input/`
3. Run FFmpeg using docker compose:
```bash
docker compose run --rm ffmpeg -i input/video.mp4 output/converted.mp4
```
### Example Configurations
The `examples/` directory contains specialized docker-compose files for common tasks:
#### Video Conversion (`examples/docker-compose.convert.yml`)
```bash
# Convert MP4 to WebM
docker compose -f examples/docker-compose.convert.yml run --rm mp4-to-webm
# Compress video
docker compose -f examples/docker-compose.convert.yml run --rm compress-video
# Convert to H.265
docker compose -f examples/docker-compose.convert.yml run --rm convert-to-h265
```
#### Media Extraction (`examples/docker-compose.extract.yml`)
```bash
# Extract audio from video
docker compose -f examples/docker-compose.extract.yml run --rm extract-audio-mp3
# Extract video thumbnails
docker compose -f examples/docker-compose.extract.yml run --rm extract-thumbnails
# Extract specific segment
START_TIME=00:01:30 DURATION=00:00:45 docker compose -f examples/docker-compose.extract.yml run --rm extract-segment
```
#### Streaming (`examples/docker-compose.stream.yml`)
```bash
# Stream to RTMP server
# Use environment variables or secret management tools
# Example: export STREAM_KEY="your-actual-key" before running
RTMP_URL=rtmp://your.server/live/ STREAM_KEY=${STREAM_KEY} docker compose -f examples/docker-compose.stream.yml run --rm rtmp-stream
# Create HLS stream
docker compose -f examples/docker-compose.stream.yml run --rm hls-stream
```
#### Batch Processing (`examples/docker-compose.batch.yml`)
```bash
# Compress all videos in input directory
docker compose -f examples/docker-compose.batch.yml run --rm batch-compress-all
# Generate thumbnails for all videos
docker compose -f examples/docker-compose.batch.yml run --rm batch-generate-thumbnails
# Custom batch processing
FFMPEG_ARGS="-c:v libx265 -crf 28" docker compose -f examples/docker-compose.batch.yml run --rm batch-custom
```
### Environment Variables
Many compose services support environment variables for customization:
- `FFMPEG_VERSION`: Specify FFmpeg image version (default: latest)
- `CRF`: Compression quality (lower = better quality, larger file)
- `PRESET`: Encoding speed preset (ultrafast, fast, medium, slow)
- `RTMP_URL`: RTMP server URL for streaming
- `START_TIME`, `DURATION`: For segment extraction
- See individual compose files for more options
### Tips
1. **Custom Commands**: Override the default command:
```bash
docker compose run --rm ffmpeg -i input/video.mp4 -vf scale=640:480 output/small.mp4
```
2. **Multiple Files**: Use the batch processing configurations for processing multiple files efficiently
3. **Persistent Settings**: The repository includes a `.env` file with default settings. You can modify it to set your preferred versions:
```env
FFMPEG_VERSION=7.1.1-alpine3.22.1-1
RTMP_URL=rtmp://streaming.server/live/
```
## Versioning
This project uses semantic versioning that matches the Docker image contents:
**Format:** `{ffmpeg_version}-alpine{alpine_version}-{build_number}`
Examples:
- `7.1.1-alpine3.22.0-1` - FFmpeg 7.1.1 on Alpine 3.22.0, build 1
- `latest` - Most recent stable release
For detailed release process and versioning guidelines, see [RELEASE.md](RELEASE.md).
## Automated Dependency Updates
This project uses [Renovate](https://docs.renovatebot.com/) to automatically check for updates to:
- Alpine Linux base image version (all major, minor, and patch updates)
- FFmpeg version
Renovate runs weekly (every Monday) and creates pull requests when updates are available. The configuration tracks
both Alpine Linux and FFmpeg releases, creating separate pull requests for each update.
## Documentation
- [Development Guide](DEVELOPMENT.md) - Building, debugging, and contributing
- [Testing Guide](TEST.md) - Running and writing tests
- [Release Process](RELEASE.md) - Creating releases and versioning
## Links
- [FFmpeg Documentation](https://ffmpeg.org/documentation.html)
- [Alpine Linux](https://www.alpinelinux.org/)
# License
MIT License
Copyright (c) 2025 Michael Wiesendanger
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.