Create Word (DOCX) or PDF in Docker container

GemBox.Document can be used inside docker containers that are running .NET Docker images.

To use Docker, you must first install Docker Desktop. After that, you can containerize your .NET application.

Visual Studio container tool for adding Docker to existing .NET Core project
Screenshot of Visual Studio container tool

The following is a project file for the .NET Core application with added Docker support.

<Project Sdk="Microsoft.NET.Sdk">


    <PackageReference Include="GemBox.Document" Version="*" />
    <PackageReference Include="SkiaSharp.NativeAssets.Linux" Version="*" />
    <PackageReference Include="HarfBuzzSharp.NativeAssets.Linux" Version="*" />


To configure or customize a Docker image, you'll need to edit the Dockerfile.

When creating PDF or image files, the font files need to be present in the container. The official Linux images for .NET won't have any fonts installed. So, you'll need to copy the necessary font files to the Linux container, or install a font package like ttf-mscorefonts-installer, or add them as Private Fonts.

The following example shows how you can create DOCX and PDF files from Docker containers and configure Docker images with Dockerfile.

Generated Word document (DOCX format) and PDF file from Docker container
Screenshot of Word and PDF files created with Docker container
FROM AS base

FROM AS build
COPY ["DocumentDocker.csproj", ""]
RUN dotnet restore "./DocumentDocker.csproj"
COPY . .
WORKDIR "/src/."
RUN dotnet build "DocumentDocker.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "DocumentDocker.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM base AS final

# Update package sources to include supplemental packages (contrib archive area).
RUN sed -i 's/main/main contrib/g' /etc/apt/sources.list.d/debian.sources

# Downloads the package lists from the repositories.
RUN apt-get update

# Install font configuration.
RUN apt-get install -y fontconfig

# Install Microsoft TrueType core fonts.
RUN apt-get install -y ttf-mscorefonts-installer

# Or install Liberation TrueType fonts.
# RUN apt-get install -y fonts-liberation

# Or some other font package...

COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "DocumentDocker.dll"]
using GemBox.Document;

class Program
    static void Main()

        // Create new document.
        var document = new DocumentModel();

        // Add sample text.
            .LoadText("Lorem Ipsum\n", new CharacterFormat() { FontColor = Color.Red, Bold = true })
            .LoadText("Lorem Ipsum\n", new CharacterFormat() { FontColor = Color.Green, Italic = true })
            .LoadText("Lorem Ipsum\n", new CharacterFormat() { FontColor = Color.Blue, UnderlineStyle = UnderlineType.Single });

        // Add sample image.
            .InsertRange(new Picture(document, "%#Dices.png%").Content);

        // Save document in DOCX and PDF format.
Imports GemBox.Document

Module Program

    Sub Main()


        ' Create new document.
        Dim document As New DocumentModel()

        ' Add sample text.
        document.Content.End _
            .LoadText("Lorem Ipsum" + vbLf, New CharacterFormat() With {.FontColor = Color.Red, .Bold = True}) _
            .LoadText("Lorem Ipsum" + vbLf, New CharacterFormat() With {.FontColor = Color.Green, .Italic = True}) _
            .LoadText("Lorem Ipsum" + vbLf, New CharacterFormat() With {.FontColor = Color.Blue, .UnderlineStyle = UnderlineType.Single})

        ' Add sample image.
        document.Content.End _
            .InsertRange(New Picture(document, "%#Dices.png%").Content)

        ' Save document in DOCX and PDF format.
    End Sub
End Module

Using full functionality of GemBox.Document on a Linux host requires adjustments explained in detail on Supported Platforms help page.

See also

Next steps

GemBox.Document is a .NET component that enables you to read, write, edit, convert, and print document files from your .NET applications using one simple API. How about testing it today?

Download Buy