Flux Bootstrap GH Pages Quick Fix - GitHub Pages Bootstrap

Flux bootstrap with GitHub Pages integration serves cluster documentation or status pages. Misconfigured Pages settings prevent site publishing. This guide covers the fix.

Quick Fix

Wrong

flux bootstrap github \
  --owner=myorg \
  --repository=my-cluster \
  --branch=gh-pages

Using gh-pages branch for Flux bootstrap is incorrect — Flux uses this as the main branch for manifests. GitHub Pages should be a separate deployment.

Right

flux bootstrap github \
  --owner=myorg \
  --repository=my-cluster \
  --branch=main \
  --path=clusters/production

# Then configure GitHub Pages separately:
# In repo Settings > Pages > Source: GitHub Actions

# Expected output after applying the fix
# Flux bootstrap on main branch
# GitHub Pages configured separately via Actions
# Cluster status documentation deployed to Pages
# Flux reconciliation and Pages deployment both working

Prevention

• Bootstrap Flux on main branch, not gh-pages
• Use GitHub Actions for Pages deployment separately
• Configure Pages source as "GitHub Actions" for flexible deployment
• Use --path for organized cluster configurations
• Keep Flux configuration and Pages content in separate paths

DodaTech Tools

Doda Browser's Pages deployer integrates with Flux for automated documentation updates. DodaZIP archives Pages configurations. Durga Antivirus Pro validates Pages content security.

FAQ