Here is an example project to show how to use the ABCpdf docker hub images to build, debug and deply an ABCpdf-powered containerized microservice.
This project was initially generated using the ASP.NET Core Web API template using Visual Studio 2026 with the default options of Docker and OpenAPI support enabled. It uses the minimal API model to expose a test endpoint.
- Visual Studio 2026 or Later (it may also work in earlier versions)
- Docker Desktop or Docker Community Edition
Clone the ABCpdfLinuxContainer repository and open the solution in Visual Studio 2026.
You will need to add your ABCpdf license key to your local dotnet secrets store for the project.
cd .\ABCpdfLinuxContainer\
dotnet user-secrets init
dotnet user-secrets set "ABCpdf:LicenseKey" "[-- PASTE YOUR LICENSE CODE HERE --]"NB: You are responsible for keeping your ABCpdf license key secure. For this reason we strongly recommend you use secrets to store. You should never persist your license key in a code repository.
Select Docker from the Debugging toolbar dropdown if it is not already selected. You may be prompted to start Docker Desktop which you should do - it has to be running to run the project in a container.
The first time the solution is opened and Docker debugging is selected you will have to wait some time while Visual Studio performs the background task of "Warming up Docker debugging". This is performing a preliminary build of the Dockerfile including pulling the required images from Docker Hub. To see what it is doing and when it has finished check the "Output" tab and "Container Tools" from the dropdown.
Be prepared for this to take 5 or more minutes the first time. This is the only time you have to wait this long as the build is cached making the subsequent development workflow very fast.
Once the Dockerfile has been built as indicated in the Container Tools Output window you can run the application from the debug toolbar as Docker:
This will spin up a container to run the application launch your default browser to the OpenAPI swagger page.
The Swagger UI will show one GET endpoint of /htmltopdf/ which simply implements AddImageHtml() on the text.
Expand the section for this endpoint and click the "Try it out" button and enter some HTML like the following.
<p><strong>Hello</strong> <em>world</em> 🙂
Now you should see the byte array contents of a PDF document displayed as text in the "Response Body" text area which is not very useful!
To actually view the generated PDF copy the link in the "Request URL" and paste it into the address bar of your browser. It will be something like the following but with a randomly generated port:
http://localhost:5521/htmltopdf?htmlString=%3Cb%3EHello%3C%2Fb%3E%20%3Cem%3Eworld%3C%2Fem%3EThis should load up a PDF in the browser as follows:
The abcpdf Docker image used have support for a number of language character sets. You may test this with the application using the following Ukrainian, Arabic and Hebrew language examples:
<p><strong>Привіт</strong> <em>Світ</em></p>
<p><strong>مرحبا</strong> <em>بالعالم</em></p>
<p><strong>שלום</strong> <em>עולם</em></p>For other languages you will need to install additional fonts and/or language pack resources in the Dockerfile.
A good balance for CJK languages is to simply add the installation of the Google's Noto fonts CJK package to the Dockerfile:
FROM abcpdf/abcpdf:14 AS base
WORKDIR /app
EXPOSE 8080
RUN apt-get update && apt-get install -y fonts-noto-cjk
RUN fc-cache -f -vThere are additional Noto languages packages here.
Alternatively you may install the relevant language packs using following commands to the runtime Dockerfile:
FROM abcpdf/abcpdf:14 AS base
WORKDIR /app
EXPOSE 8080
RUN apt-get update
# Japanese
RUN apt-get install -y language-pack-ja install japan*
# Chinese
RUN apt-get install -y language-pack-zh* chinese*
# Korean
RUN apt-get install -y language-pack-ko install korean*Other languages may be installed in a similar fashion. See the Ubuntu language pack pages to find your desired language pack.
The Dockerfiles used to create the Docker Hub Docker images are available here. You may use these to roll-your-own image.
All of our images are rebuilt with the latest OS security and package updates and pushed to the Docker Hub every Tuesday at 3am UTC.
We now offer chiseled Ubuntu images to maximise your application's attack surface. These images contain no shell and virtually no commands. These are strongly recommended for production environments.
The Dockerfile we use in this project makes use of the 'app' USER as specified in the ASP.NET Core Runtime images. This ensures that root access is unavailable in the deployed container in production if you are unable to use chiseled images (see above).
You should refer to ABCpdf Dockerfile GitHub repoisto for the latest docker-specific information.