[PDFBOX-5181] pdfbox-app doesn't run in a headless environment

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.0.0 PDFBox
• Fix Version/s: 3.0.0 PDFBox
• Component/s: Utilities
• Assignee: Maruan Sahyoun
• Reporter: Tilman Hausherr
• Created: 29/Apr/21 03:22
• Updated: 18/Aug/23 05:46
• Resolved: 30/Apr/21 13:00

Description

Follow-up to PDFBOX-2602

...
Caused by: java.awt.HeadlessException:
No X11 DISPLAY variable was set, but this program performed an operation which requires it.
        at java.desktop/java.awt.GraphicsEnvironment.checkHeadless(GraphicsEnvironment.java:208)
        at java.desktop/java.awt.Window.<init>(Window.java:548)
        at java.desktop/java.awt.Frame.<init>(Frame.java:423)
        at java.desktop/java.awt.Frame.<init>(Frame.java:388)
        at java.desktop/javax.swing.JFrame.<init>(JFrame.java:180)
        at org.apache.pdfbox.debugger.PDFDebugger.<init>(PDFDebugger.java:208)
        ... 18 more

PDFDebugger it itself an awt object (a JFrame).

We may also run into problems with tools that use awt, e.g. PDFToImage.

Issue Links

• relates to: PDFBOX-2602 Enhance command line tools