drawio-headless

# Draw.io Headless Diagram Generation Generate professional architecture diagrams from .drawio XML files in headless environments (WSL2, VPS, Docker) where GUI is not available. ## When to Use - Server/VPS without X11 display - WSL2 Ubuntu (no native GUI) - Docker containers - CI/CD pipelines - Automated diagram generation ## Prerequisites **Required packages:** ```bash # Install draw.io (snap - easiest) sudo snap install drawio # Install Xvfb (virtual framebuffer for headless rendering) sudo apt-get update sudo apt-get install -y xvfb ``` **Alternative: .deb package** ```bash # Download latest .deb wget https://github.com/jgraph/drawio-desktop/releases/download/v28.2.5/drawio-amd64-28.2.5.deb # Install sudo dpkg -i drawio-amd64-28.2.5.deb sudo apt-get install -f # Fix dependencies ``` ## Verification ```bash # Check draw.io installation which drawio # Expected: /snap/bin/drawio or /usr/bin/drawio # Test with xvfb-run xvfb-run -a drawio --version # Expected: draw.io version number (e.g., 28.2.5) ``` ## Usage ### Basic Export ```bash # Export .drawio to PNG xvfb-run -a drawio -x -f png -o output.png input.drawio # Export to SVG xvfb-run -a drawio -x -f svg -o output.svg input.drawio # Export to PDF xvfb-run -a drawio -x -f pdf -o output.pdf input.drawio ``` ### Flags Explained - `xvfb-run -a` — Run in virtual framebuffer (headless) - `-x` — Export mode - `-f <format>` — Output format (png, svg, pdf, jpg) - `-o <output>` — Output file path - `<input>` — Input...