Skip to content

Commit 0fc133d

Browse files
committed
Add note about font files and move up font and tls secitons
1 parent 093ba8d commit 0fc133d

File tree

1 file changed

+21
-16
lines changed

1 file changed

+21
-16
lines changed

README.md

Lines changed: 21 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,11 @@ alias ffprobe='docker run -i --rm -u $UID:$GROUPS -v "$PWD:$PWD" -w "$PWD" --ent
9797
- `/doc` Documentation
9898
- `/versions.json` JSON file with build versions of ffmpeg and libraries.
9999
- `/etc/ssl/cert.pem` CA certs to make `-tls_verify 1 -ca_file /etc/ssl/cert.pem` work if running image directly
100+
- Fonts, fontconfig config and pre-populated cache:
101+
- `/etc/fonts`
102+
- `/usr/share/fonts`
103+
- `/usr/share/consolefonts`
104+
- `/var/cache/fontconfig`
100105

101106
### Tags
102107

@@ -117,6 +122,22 @@ Due to license issues the docker image does not include libfdk-aac by default. A
117122
docker build --build-arg ENABLE_FDKAAC=1 . -t my-ffmpeg-static:latest
118123
```
119124

125+
### Fonts usage with SVG or draw text filters etc
126+
127+
The image ships with some basic fonts (`font-terminus font-inconsolata font-dejavu font-awesome`) that can be used when running the image directly. If your copying the binaries into some image you have to install fonts somehow. How to do this depends a bit on distributions but in general look for font packages and how to make [fontconfig](https://www.freedesktop.org/wiki/Software/fontconfig/) know about them.
128+
129+
- Alpine Linux see https://wiki.alpinelinux.org/wiki/Fonts
130+
- Debian/Ubuntu see https://wiki.debian.org/Fonts
131+
132+
### TLS
133+
134+
Binaries are built with TLS support but, by default, ffmpeg currently do
135+
not do certificate verification. To enable verification you need to run
136+
ffmpeg with `-tls_verify 1` and `-ca_file /path/to/cert.pem`.
137+
138+
- Alpine Linux at `/etc/ssl/cert.pem`
139+
- Debian/Ubuntu install the `ca-certificates` package at it will be available at `/etc/ssl/certs/ca-certificates.crt`.
140+
120141
### Known issues and tricks
121142

122143
#### Multi-arch and arm64
@@ -141,22 +162,6 @@ docker run --rm mwader/static-ffmpeg -v quiet -f data -i versions.json -map 0 -c
141162
This could happen if the hostname resolve to more IP-addresses than can fit in [DNS UDP packet](https://www.rfc-editor.org/rfc/rfc791) (probably 512 bytes) causing the response to be truncated. Usually clients should then switch to TCP and redo the query.
142163
This should only be a problem with version 6.0-1 or earlier of this image that uses [musl libc](https://www.musl-libc.org) 1.2.3 or older.
143164

144-
### Fonts usage with SVG or draw text filters etc
145-
146-
The image ships with some basic fonts (`font-terminus font-inconsolata font-dejavu font-awesome`) that can be used when running the image directly. If your copying the binaries into some image you have to install fonts somehow. How to do this depends a bit on distributions but in general look for font packages and how to make [fontconfig](https://www.freedesktop.org/wiki/Software/fontconfig/) know about them.
147-
148-
- Alpine Linux see https://wiki.alpinelinux.org/wiki/Fonts
149-
- Debian/Ubuntu see https://wiki.debian.org/Fonts
150-
151-
### TLS
152-
153-
Binaries are built with TLS support but, by default, ffmpeg currently do
154-
not do certificate verification. To enable verification you need to run
155-
ffmpeg with `-tls_verify 1` and `-ca_file /path/to/cert.pem`.
156-
157-
- Alpine Linux at `/etc/ssl/cert.pem`
158-
- Debian/Ubuntu install the `ca-certificates` package at it will be available at `/etc/ssl/certs/ca-certificates.crt`.
159-
160165
### Docker Hub images
161166

162167
Multi-arch dockerhub images are built using [pyldin601/build-multiarch-on-aws-spots](https://github.com/pyldin601/build-multiarch-on-aws-spots). See [build-multiarch.yml](.github/workflows/build-multiarch.yml) for config. Thanks to [@pyldin601](https://github.com/pyldin601) for making this possible.

0 commit comments

Comments
 (0)