mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-05 00:29:48 +03:00
Problem with wkhtmltopdf #1694
Closed
opened 2026-02-05 01:38:25 +03:00 by OVERLORD
·
7 comments
No Branch/Tag Specified
development
l10n_development
further_theme_development
release
llm_only
vectors
v25-11
docker_env
drawio_rendering
user_permissions
ldap_host_failover
svg_image
prosemirror
captcha_example
fix/video-export
v25.12.3
v25.12.2
v25.12.1
v25.12
v25.11.6
v25.11.5
v25.11.4
v24.11.4
v25.11.3
v25.11.2
v25.11.1
v25.11
v25.07.3
v25.07.2
v25.07.1
v25.07
v25.05.2
v25.05.1
v25.05
v25.02.5
v25.02.4
v25.02.3
v25.02.2
v25.02.1
v25.02
v24.12.1
v24.12
v24.10.3
v24.10.2
v24.10.1
v24.10
v24.05.4
v24.05.3
v24.05.2
v24.05.1
v24.05
v24.02.3
v24.02.2
v24.02.1
v24.02
v23.12.3
v23.12.2
v23.12.1
v23.12
v23.10.4
v23.10.3
v23.10.2
v23.10.1
v23.10
v23.08.3
v23.08.2
v23.08.1
v23.08
v23.06.2
v23.06.1
v23.06
v23.05.2
v23.05.1
v23.05
v23.02.3
v23.02.2
v23.02.1
v23.02
v23.01.1
v23.01
v22.11.1
v22.11
v22.10.2
v22.10.1
v22.10
v22.09.1
v22.09
v22.07.3
v22.07.2
v22.07.1
v22.07
v22.06.2
v22.06.1
v22.06
v22.04.2
v22.04.1
v22.04
v22.03.1
v22.03
v22.02.3
v22.02.2
v22.02.1
v22.02
v21.12.5
v21.12.4
v21.12.3
v21.12.2
v21.12.1
v21.12
v21.11.3
v21.11.2
v21.11.1
v21.11
v21.10.3
v21.10.2
v21.10.1
v21.10
v21.08.6
v21.08.5
v21.08.4
v21.08.3
v21.08.2
v21.08.1
v21.08
v21.05.4
v21.05.3
v21.05.2
v21.05.1
v21.05
v21.04.6
v21.04.5
v21.04.4
v21.04.3
v21.04.2
v21.04.1
v21.04
v0.31.8
v0.31.7
v0.31.6
v0.31.5
v0.31.4
v0.31.3
v0.31.2
v0.31.1
v0.31.0
v0.30.7
v0.30.6
v0.30.5
v0.30.4
v0.30.3
v0.30.2
v0.30.1
v0.30.0
v0.29.3
v0.29.2
v0.29.1
v0.29.0
v0.28.3
v0.28.2
v0.28.1
v0.28.0
v0.27.5
v0.27.4
v0.27.3
v0.27.2
v0.27.1
v0.27
v0.26.4
v0.26.3
v0.26.2
v0.26.1
v0.26.0
v0.25.5
v0.25.4
v0.25.3
v0.25.2
v0.25.1
v0.25.0
v0.24.3
v0.24.2
v0.24.1
v0.24.0
v0.23.2
v0.23.1
v0.23.0
v0.22.0
v0.21.0
v0.20.3
v0.20.2
v0.20.1
v0.20.0
v0.19.0
v0.18.5
v0.18.4
v0.18.3
v0.18.2
v0.18.1
v0.18.0
v0.17.4
v0.17.3
v0.17.2
v0.17.1
v0.17.0
v0.16.3
v0.16.2
v0.16.1
v0.16.0
v0.15.3
v0.15.2
v0.15.1
v0.15.0
v0.14.3
v0.14.2
v0.14.1
v0.14.0
v0.13.1
v0.13.0
v0.12.2
v0.12.1
v0.12.0
v0.11.2
v0.11.1
v0.11.0
v0.10.0
v0.9.3
v0.9.2
v0.9.1
v0.9.0
v0.8.2
v0.8.1
v0.8.0
v0.7.6
v0.7.5
v0.7.4
v0.7.3
0.7.2
v.0.7.1
v0.7.0
v0.6.3
v0.6.2
v0.6.1
v0.6.0
v0.5.0
Labels
Clear labels
🎨 Design
📖 Docs Update
🐛 Bug
🐛 Bug
:cat2:🐈 Possible duplicate
💿 Database
☕ Open to discussion
💻 Front-End
🐕 Support
🚪 Authentication
🌍 Translations
🔌 API Task
🏭 Back-End
⛲ Upstream
🔨 Feature Request
🛠️ Enhancement
🛠️ Enhancement
🛠️ Enhancement
❤️ Happy feedback
🔒 Security
🔍 Pending Validation
💆 UX
📝 WYSIWYG Editor
🌔 Out of scope
🔩 API Request
:octocat: Admin/Meta
🖌️ View Customization
❓ Question
🚀 Priority
🛡️ Blocked
🚚 Export System
♿ A11y
🔧 Maintenance
> Markdown Editor
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: starred/BookStack#1694
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @techauthoruk on GitHub (Apr 30, 2020).
Hi
Having a problem using wkhtmltopdf for generating my pdfs. Originally, I was using the default dompdf setup, which worked fine, but the output (particularly of tables) wasn't very good. So I installed wkhtmltopdf on my server (running Ubuntu 18.04) and copied it to the Bookstack directory (which is exactly what I did on my other install on a different server - running CentOS 8.1).
I changed the permissions for wkhtmltopdf to root:root 0750 (same as my other server), but when I try to create a pdf I get:
An Error Occurred
An unknown error occurred
Instead I tried adding the path to wkhtmltopdf in the .env file, but same result.
Anyone any suggestions how to sort this?
Thanks
Mark
@ssddanbrown commented on GitHub (Apr 30, 2020):
@techauthoruk You can follow the debugging guide to gain more detail on the error:
https://www.bookstackapp.com/docs/admin/debugging/
Sometimes I have had to run wkhtml through
xvfb-runbefore since WKHTML sometimes needs an X server depending on version and system, But the logs should have some clues as to what's happening.@techauthoruk commented on GitHub (May 1, 2020):
@ssddanbrown
Thanks for that. This is the error detail:
RuntimeException
The exit status code '126' says something went wrong: stderr: "sh: 1: /var/www/bookstack/wkhtmltopdf: Permission denied " stdout: "" command: /var/www/bookstack/wkhtmltopdf --lowquality --print-media-type '/tmp/knp_snappy5eab9d91b32850.22533742.html' '/tmp/knp_snappy5eab9d91b331a7.99555749.pdf'.
I don't understand the permission denied error, as all the permissions look ok as I previously mentioned. In the laravel log file I see this several times:
command: /var/www/bookstack/wkhtmltopdf --lowquality --print-media-type '/tmp/knp_snappy5e9e59e5d3bcf1.53933425.html' '/tmp/knp_snappy5e9e59e5d3c652.35544182.pdf'. {"userId":1,"exception":"[object] (RuntimeException(code: 1): The exit status code '1' says something went wrong:
stderr: "The switch --print-media-type, is not support using unpatched qt, and will be ignored.QStandardPaths: XDG_RUNTIME_DIR not set, defaulting to '/tmp/runtime-www-data'
qt.qpa.screen: QXcbConnection: Could not connect to display
Could not connect to any X display.
So is this what you mentioned about running wkhtmltopdf through
xvfb-run? How would I do that?Many thanks for your asssitance.
Mark
@techauthoruk commented on GitHub (May 1, 2020):
@ssddanbrown
Problem solved - I found a tutorial explaining how to set up xvfb, and wkhtmltopdf now works with Bookstack
Thanks for the help - I will close this issue now.
Mark
@ssddanbrown commented on GitHub (May 1, 2020):
@techauthoruk Ah, great, glad you got it working!
@gor181 commented on GitHub (Mar 4, 2022):
Just a note to anyone who is having issues with this. The setup is as follows:
Please understand the security implications of the
ALLOW_UNTRUSTED_SERVER_FETCHINGoption before using.@ssddanbrown commented on GitHub (Mar 4, 2022):
Updated the above with a note of the security implications of using the displayed options.
@Mohamed-sobhi95 commented on GitHub (Nov 5, 2023):
How to enable wkhtmltopdf in the docker compose version