Skip to content

fix: pass Chromium sandbox flags to the HTML render step - #73

Merged
jhosepmyr merged 1 commit into
developfrom
bugfix/word-html-render-sandbox-flag
Jul 10, 2026
Merged

fix: pass Chromium sandbox flags to the HTML render step#73
jhosepmyr merged 1 commit into
developfrom
bugfix/word-html-render-sandbox-flag

Conversation

@jhosepmyr

Copy link
Copy Markdown
Contributor

Description of Change

Section modified: CI/CD — .github/workflows/generate-pdf.yml (Render full HTML for Word conversion step)

Motivation: The last push to main (after merging PR #70) broke the Generate PDF from README workflow in production. The new "Render full HTML for Word conversion" step calls md-to-pdf --as-html, which still launches Puppeteer/Chromium under the hood, but was missing the --no-sandbox --disable-setuid-sandbox launch options already used by the "Generate PDF" step. On GitHub Actions runners (no usable user-namespace sandbox), Chromium crashed with "No usable sandbox", failing the run right after PR #72 merged develop into main.


Type of Change

  • New section or subsection
  • Update to existing content
  • New diagram or image
  • Typo or writing correction
  • Incorrect data or information fix
  • Structure reorganization (no content change)
  • Asset change (image replacement)

Checklist Before Requesting Review

  • The PR targets develop (not main)
  • The branch name follows the convention feature/* or bugfix/*
  • Commits follow the Conventional Commits convention (feat:, fix:, docs:, etc.)
  • CHANGELOG.md has been updated with the change made
  • New images are placed in the correct assets/ subfolder — N/A
  • Image links in the README render correctly — N/A
  • Spelling of added or modified content has been reviewed — N/A
  • No generated files are included (.pdf, .docx, .html)

Screenshots or Evidence (optional)

Failing run on main after PR #72: workflow Generate PDF from README, run 29069830937 — Chromium FATAL: No usable sandbox!. Verified locally that md-to-pdf --as-html --basedir . --launch-options '{"args":["--no-sandbox","--disable-setuid-sandbox"]}' runs cleanly with the flag added.


Suggested Reviewers

@jhosepmyr

md-to-pdf --as-html still launches Puppeteer/Chromium under the hood, but
this step was missing the --no-sandbox/--disable-setuid-sandbox launch
options already used by the PDF step. On GitHub Actions runners (no
usable user namespace sandbox), Chromium crashed with 'No usable sandbox',
breaking the CI run on push to main.
@jhosepmyr
jhosepmyr merged commit eda7c04 into develop Jul 10, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant