n8n-nodes-graphx-pdf
v0.1.0
Published
n8n community node for a managed GraphX Gotenberg PDF service
Maintainers
Readme
n8n-nodes-graphx-pdf
GraphX PDF is an n8n community node for a separately deployed Gotenberg service. The node does not contain, install, or launch Gotenberg. It sends conversion requests to the configured service over HTTPS and returns the generated document as n8n binary data.
Installation
Install n8n-nodes-graphx-pdf from Settings > Community Nodes in a self-hosted n8n instance, or install it in the n8n user directory:
npm install n8n-nodes-graphx-pdfCredentials
Create a GraphX PDF API credential with:
- Base URL: the HTTPS origin of the separately hosted GraphX PDF service, without a route path. A trailing slash is accepted and removed internally.
- Access Client ID: the client ID from a Cloudflare Access service token.
- Access Client Secret: the matching Cloudflare Access service token secret.
The credential sends CF-Access-Client-Id and CF-Access-Client-Secret headers. Its connection test calls GET /health. Keep the service token in n8n credentials; do not place it in workflow JSON or expressions.
Convert HTML to PDF
- Add a GraphX PDF node.
- Select PDF > Convert HTML to PDF.
- Choose JSON String or Binary File as the HTML source.
- For JSON input, place the HTML string in
ticket_htmlor change HTML Property. - For binary input, select the n8n binary property containing the HTML file.
- Set the output binary property and filename, then execute the node.
Example input:
{
"ticket_html": "<!doctype html><html><body><h1>Example</h1></body></html>",
"recordId": "example-001"
}The node preserves the original JSON, uploads the HTML to Gotenberg as index.html, and writes the returned PDF to the configured binary property. The binary metadata includes the normalized .pdf filename, application/pdf MIME type, and pdf extension. Each incoming n8n item produces a separate output item.
Service Requirements
- Deploy Gotenberg separately from this npm package.
- Expose the Gotenberg health and conversion routes through HTTPS.
- Protect the service with a Cloudflare Access service credential.
- Permit
GET /healthandPOST /forms/chromium/convert/htmlfor the service token.
Current Scope
Version 0.1.0 implements HTML-to-PDF conversion. The planned full Gotenberg route expansion is tracked in docs/FULL-SERVICE-ROADMAP.md.
License
MIT
