Own Fonts

[MeisterAdebar]

Hi,

1. Create a folder for custom fonts

mkdir -p /usr/share/fonts/TTF

2. Upload the font
   Either via docker cp from the host:

docker cp MyFont.ttf fewohbee-dockerized-php-1:/usr/share/fonts/TTF/

Or inside the container using wget/curl if the font is available online.

3. Update the font cache

fc-cache -fv

4. Restart the container (so that wkhtmltopdf recognizes the new font)

docker restart fewohbee-dockerized-php-1

Question: Is this the correct approach for adding custom fonts inside the container, or is there an easier way?

Thomas

[developeregrem]

Hi,
this is one approach. I assume you run apk add fontconfigbefore, right?
With your approach you need to keep in mind that your changes will get lost whenever the container is recreated (a simple change in the.env file can cause this).

A better approach would be like this (is a bit more complex but you keep your changes at any time)

Update docker-compose file like this:

php:
        image: developeregrem/fewohbee-phpfpm:latest
        volumes:
            - feb-data:/var/www/html:cached
            - ./conf/php/conf.ini:/usr/local/etc/php/conf.d/conf.ini
            - ${WWW_ROOT}:/var/www/data:cached
            - ../fonts:/usr/share/fonts/TTF:ro
            - ./conf/php/entrypoint-wrapper.sh:/usr/local/bin/entrypoint-wrapper.sh:ro
        networks:
            - internal-network
        entrypoint: ["/usr/local/bin/entrypoint-wrapper.sh"]

added two new lines in volumes and the entrypoint line.
The first new line in volumes adds your fonts in your local folder (../fonts, needs to be created) to the container folder (/usr/share/fonts/TTF)

Now the tricky part is to keep the original start sequence of the image but add your font cache update command.
If you do not want to build your own image, you should use a wrapper entrypoint script which you place in your local folder fewohbee-dockerized/conf/php/entrypoint-wrapper.sh
And the file can look like this:

#!/bin/sh
set -e

if ! command -v fc-cache >/dev/null 2>&1; then
    apk add --no-cache fontconfig
fi
fc-cache -fv

# Preserve original CMD behavior if none is provided.
if [ "$#" -eq 0 ]; then
    set -- php-fpm
fi
exec /entrypoint.sh "$@"

Afterwards you should stop and start all containers:

docker compose stop
docker compose up -d

Check if you see your font update logs with docker compose logs php

[MeisterAdebar]

    php:
        image: developeregrem/fewohbee-phpfpm:latest
        volumes:
            - feb-data:/var/www/html:cached
            - ./conf/php/conf.ini:/usr/local/etc/php/conf.d/conf.ini
            - ${WWW_ROOT}:/var/www/data:cache
            - ../fonts:/usr/share/fonts/TTF:ro
            - ./conf/php/entrypoint-wrapper.sh:/usr/local/bin/entrypoint-wrapper.sh:ro
        networks:
            - internal-network
        entrypoint: ["/usr/local/bin/entrypoint-wrapper.sh"]

drwx--x--x  4 root root      4096 24. Nov 2024  containerd
drwxr-xr-x  4 root root      4096 16. Mär 2025  data
drwxr-xr-x  2 root root      4096 29. Dez 13:34 dbbackup
drwxr-xr-x  7 root root      4096 31. Dez 15:26 fewohbee-dockerized
drwxr-xr-x  2 root root      4096 31. Dez 14:03 fonts
-rw-r--r--  1 root root    563183 29. Dez 01:30 home

pi@fhempi:/opt/fewohbee-dockerized $ sudo docker compose logs php
php-1  | (1/1) Installing fontconfig (2.17.1-r0)
php-1  | Executing busybox-1.37.0-r30.trigger
php-1  | OK: 86.7 MiB in 77 packages
php-1  | Font directories:
php-1  |        /root/.local/share/fonts
php-1  |        /usr/local/share/fonts
php-1  |        /usr/share/fonts
php-1  |        /root/.fonts
php-1  |        /usr/share/fonts/TTF
php-1  | /root/.local/share/fonts: skipping, no such directory
php-1  | /usr/local/share/fonts: skipping, no such directory
php-1  | /usr/share/fonts: caching, new cache contents: 0 fonts, 1 dirs
php-1  | /usr/share/fonts/TTF: caching, new cache contents: 2 fonts, 0 dirs
php-1  | /root/.fonts: skipping, no such directory
php-1  | /usr/share/fonts/TTF: skipping, looped directory detected
php-1  | /var/cache/fontconfig: cleaning cache directory
php-1  | /root/.cache/fontconfig: not cleaning non-existent cache directory
php-1  | /root/.fontconfig: not cleaning non-existent cache directory
php-1  | fc-cache: succeeded
php-1  | HEAD is now at e9d2333 Merge pull request #148 from developeregrem/4.0.1-dev
php-1  | Installing dependencies from lock file
php-1  | Verifying lock file contents can be installed on current platform.
php-1  | Nothing to install, update or remove
php-1  | Generating optimized autoload files
php-1  | 94 packages you are using are looking for funding.
php-1  | Use the `composer fund` command to find out more!
php-1  | 
php-1  | Run composer recipes at any time to see the status of your Symfony recipes.
php-1  | 
php-1  | Executing script cache:clear [OK]
php-1  | Executing script assets:install public [OK]
php-1  | Executing script importmap:install [OK]
php-1  | 
php-1  | 
php-1  |  [OK] Already at the latest version ("DoctrineMigrations\Version20260412120000")
php-1  | 
php-1  | 
php-1  |  // Clearing cache pool: doctrine.result_cache_pool                             
php-1  | 
php-1  |  // Clearing cache pool: doctrine.system_cache_pool                             
php-1  | 
php-1  |  [OK] Cache was successfully cleared.                                           
php-1  | 
php-1  | 
php-1  |  // Compiling and writing asset files to public                                 
php-1  | 
php-1  |  // Compiled 28 assets                                                          
php-1  | 
php-1  |  // Manifest written to public/assets/manifest.json                             
php-1  | 
php-1  |  // Import map data written to public/assets/importmap.json.                    
php-1  | 
php-1  |  // Entrypoint metadata written for 1 entrypoints (app).                        
php-1  | 
php-1  | [31-Dec-2025 14:16:51] NOTICE: fpm is running, pid 1
php-1  | [31-Dec-2025 14:16:51] NOTICE: ready to handle connections
php-1  | [31-Dec-2025 14:17:11] NOTICE: Finishing ...
php-1  | [31-Dec-2025 14:17:11] NOTICE: exiting, bye-bye!

pi@fhempi:/opt/fewohbee-dockerized $ sudo docker compose exec php sh
/var/www/html # fc-list | grep -i kabel
/usr/share/fonts/TTF/KABELN.TTF: Kabel Bk BT:style=Book
/var/www/html # fc-list | grep -i ornamental
/usr/share/fonts/TTF/GSTORNRM.TTF: Ornamental:style=Regular,normal,Standard,Normaali,Normale,Standaard

But it still doesn’t take effect in the HTML:
<td style="font-family: ornamental; text-align: left; font-size: 18pt; font-weight: bold; vertical-align: bottom; border-bottom: 0.5px solid black;">Hotelname</td>

[developeregrem]

Hi,
I assume you want your own font in a PDF export based on a template in FewohBee?
And you wrote in your first post about wkhtmltopdf. Are you using it?
FewohBee uses mPDF to generate a PDF. I haven’t worked with custom fonts yet but according to the documentation a custom font needs to be added programmatically by the application https://mpdf.github.io/fonts-languages/fonts-in-mpdf-7-x.html

[MeisterAdebar]

Hi,

I’ve been working on adding a custom font:

# Create directory
sudo mkdir -p /opt/fonts

# Copy fonts there (example)
sudo cp ~/Downloads/*.TTF /opt/fonts/

For the changes to survive a container restart, the local configuration and the font directory must be mounted as volumes. Extend the PHP service in your docker-compose.yml:

services:
  php:
    volumes:
      - feb-data:/var/www/html:cached
      # Include custom fonts
      - /opt/fonts:/var/www/html/assets/fonts:ro
      # Include custom service logic
      - ./MpdfService.php:/var/www/html/fewohbee/src/Service/MpdfService.php:ro

Create a file MpdfService.php in the same directory as docker-compose.yml. This file registers the fonts in the mPDF system.

Important code excerpt:

// ... inside the getMpdf() method ...
$config = [
    // ... standard configuration ...
    'fontDir' => array_merge($fontDirs, [
        '/var/www/html/assets/fonts',
    ]),
    'fontdata' => $fontData + [
        'gston' => [
            'R' => 'GSTORNRM.TTF',
        ],
        'kabel' => [
            'R' => 'KABELN.TTF',
        ]
    ],
];

sudo docker compose down
sudo docker compose up -d

Make sure the fonts are visible inside the container:

sudo docker compose exec php ls -l /var/www/html/assets/fonts

Usage example:

<style>
    /* The name 'gston' corresponds to the key in the PHP fontdata array */
    .header-text {
        font-family: 'gston';
        font-size: 14pt;
    }
</style>

[developeregrem]

Good approach 👍
Maybe I add a general way to configure this without loosing updateability. If there are changes in the service file you need to update it manually, now.
Give me some time to think about it ☺️