PDF Generator Configuration
Last modified by Eleni Cojocariu on 2026/02/05 17:22
Reference
When configuring PDF export, you have the option to choose the tool to use for generating PDFs:

| The tool used as a PDF Generator | Description | Image |
|---|---|---|
| User Browser | This is the default setting, it generates the PDF using the user's web browser on the client side. The main advantage of this approach is that it doesn't require any external services (such as Docker or a remote headless Chrome). However, a downside is that different users, depending on their web browser or its version, may experience variations in the final PDF output | ![]() |
| Chrome Docker Container | The PDF can also be generated on the server side using a headless Chrome web browser running inside a Docker container. The application automatically handles the following tasks:
| |
| Remote Chrome Generator | If you don't want to rely on Docker, or you don't want to give XWiki access to Docker for security reasons, but you still want to perform the PDF export on the server side then you also have the option to connect to a remote Chrome instance. |
For both the Chrome Docker Container and the Remote Chrome generators, you can specify the base URI that the remote (headless) Chrome browser uses to access XWiki when generating PDFs (in particular, the print preview page). The host (domain name or IP address) is required. The scheme (e.g., HTTP or HTTPS) and the port (e.g., 8080) are optional and, if not provided, default to the values from the URL used to trigger the export. This setting replaces the deprecated XWiki Host configuration (export.pdf.xwikiHost).
FAQ
Is there any other way to configure the PDF generator?
Yes, you can configure the PDF generator by modifying the xwiki.properties file.
