[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs:deployment":3},{"versions":4,"version":13,"nav":16,"path":34,"page":80},[5,10],{"name":6,"label":7,"prefix":8,"channel":9},"0.1","0.1.0 (latest)","","latest",{"name":11,"label":12,"prefix":11,"channel":11},"next","next (main)",{"name":6,"label":7,"prefix":8,"channel":9,"base":14,"ref":15},"\u002Fdocs","v0.1.0",[17,21,24,27,30,33,36,39,43,46,49,52,55,58,61,65,68,71,74,77],{"slug":18,"title":19,"group":20},"index","Overview","Guide",{"slug":22,"title":23,"group":20},"getting-started","Getting started",{"slug":25,"title":26,"group":20},"php","PHP API",{"slug":28,"title":29,"group":20},"laravel","Laravel",{"slug":31,"title":32,"group":20},"resources","Resources",{"slug":34,"title":35,"group":20},"deployment","Deployment",{"slug":37,"title":38,"group":20},"troubleshooting","Troubleshooting",{"slug":40,"title":41,"group":42},"css","CSS reference","Reference",{"slug":44,"title":45,"group":42},"paged-media","Paged media",{"slug":47,"title":48,"group":42},"fonts","Fonts",{"slug":50,"title":51,"group":42},"extensions","Extensions",{"slug":53,"title":54,"group":42},"pdf","The PDF",{"slug":56,"title":57,"group":42},"cli","Command line",{"slug":59,"title":60,"group":42},"rust","Rust library",{"slug":62,"title":63,"group":64},"protocol","Worker protocol","Internals",{"slug":66,"title":67,"group":64},"releasing","Releasing",{"slug":69,"title":70,"group":64},"adr\u002F0001-record-architecture-decisions","1. Record architecture decisions",{"slug":72,"title":73,"group":64},"adr\u002F0002-rust-and-fragmentation-in-layout","2. Rust core with fragmentation inside layout",{"slug":75,"title":76,"group":64},"adr\u002F0003-css-parsing-and-own-selector-matching","3. lightningcss for parsing, own selector matching and cascade",{"slug":78,"title":79,"group":64},"adr\u002F0004-extensions-only-where-css-has-no-way","4. Extensions only where CSS has no way",{"title":35,"seoTitle":81,"seoDescription":82,"html":83,"headings":84,"editUrl":120,"sourceUrl":121,"markdownUrl":122,"prev":123,"next":124},"Deployment: Docker, Alpine, CI and worker processes","Install the fagus binary in CI and Docker builds, on Alpine, on servers without access to GitHub or from a build of your own; worker processes, speed, memory.","\u003Ch1 id=\"deployment\">Deployment\u003C\u002Fh1>\n\u003Cp>Fagus needs its \u003Ccode>fagus\u003C\u002Fcode> binary next to PHP on every server that renders PDFs. The Composer plugin\ninstalls it with \u003Ccode>composer install\u003C\u002Fcode>; this page covers builds, servers and processes where that\nneeds a thought.\u003C\u002Fp>\n\u003Ch2 id=\"install-the-binary-in-ci-and-docker-builds\">Install the binary in CI and Docker builds\u003Ca class=\"f-doc-anchor\" href=\"#install-the-binary-in-ci-and-docker-builds\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The plugin runs after \u003Ccode>composer install\u003C\u002Fcode> and \u003Ccode>composer update\u003C\u002Fcode> and installs the binary for the\nplatform Composer runs on, checked against the SHA-256 that the package lists for its release.\nBuilds run Composer without asking, so two things must be in place:\u003C\u002Fp>\n\u003Col>\n\u003Cli>\n\u003Cp>\u003Cstrong>The plugin is allowed in \u003Ccode>composer.json\u003C\u002Fcode>.\u003C\u002Fstrong> Composer asks interactively the first time; in a\nbuild it fails instead:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>text\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>nforst\u002Ffagus contains a Composer plugin which is blocked by your allow-plugins config. You may add it to the list if you consider it safe.\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>Commit the entry that answering \u003Ccode>y\u003C\u002Fcode> writes, or add it yourself:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>sh\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FFA657\">composer\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> config\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> allow-plugins.nforst\u002Ffagus\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> true\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003C\u002Fli>\n\u003Cli>\n\u003Cp>\u003Cstrong>The build can reach GitHub\u003C\u002Fstrong>, where the binaries are attached to the release. Installing\nfrom a private fork also needs a token that can read it: Composer's\n(\u003Ccode>github-oauth.github.com\u003C\u002Fcode> in \u003Ccode>auth.json\u003C\u002Fcode> or \u003Ccode>COMPOSER_AUTH\u003C\u002Fcode>), else \u003Ccode>FAGUS_GITHUB_TOKEN\u003C\u002Fcode> or\n\u003Ccode>GITHUB_TOKEN\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>\u003Ccode>--no-scripts\u003C\u002Fcode> does not stop the plugin; \u003Ccode>--no-plugins\u003C\u002Fcode> does. After \u003Ccode>--no-plugins\u003C\u002Fcode>, run\n\u003Ccode>vendor\u002Fbin\u002Ffagus-install\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>The plugin keeps downloaded binaries in Composer's cache directory (\u003Ccode>&lt;cache-dir&gt;\u002Ffagus\u002F&lt;version&gt;\u002F\u003C\u002Fcode>),\nso a build with a cached Composer directory downloads each binary once.\u003C\u002Fp>\n\u003Ch3 id=\"docker\">Docker\u003Ca class=\"f-doc-anchor\" href=\"#docker\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh3>\n\u003Cp>Run Composer in the image that runs the application, or install the binary there afterwards. A\nbinary installed in another image is for that image's platform, which may differ in architecture\nor C library from the image that runs PHP.\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>dockerfile\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">FROM\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> php:8.4-fpm\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">COPY\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> --from=composer:2 \u002Fusr\u002Fbin\u002Fcomposer \u002Fusr\u002Fbin\u002Fcomposer\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">WORKDIR\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> \u002Fapp\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">COPY\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> . .\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">RUN\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> composer install --no-dev --no-interaction --optimize-autoloader\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>With a multi-stage build, where Composer runs in a stage of its own, install the binary in the\nfinal stage:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>dockerfile\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">FROM\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> composer:2 \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">AS\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> vendor\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">WORKDIR\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> \u002Fapp\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">COPY\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> composer.json composer.lock .\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">RUN\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> composer install --no-dev --no-interaction --no-plugins --optimize-autoloader\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">FROM\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> php:8.4-fpm-alpine\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">WORKDIR\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> \u002Fapp\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">COPY\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> --from=vendor \u002Fapp\u002Fvendor .\u002Fvendor\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">COPY\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> . .\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">RUN\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> vendor\u002Fbin\u002Ffagus-install\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>\u003Ccode>vendor\u002Fbin\u002Ffagus-install\u003C\u002Fcode> keeps a binary that is already there with the right SHA-256 and\nreplaces one of another platform.\u003C\u002Fp>\n\u003Ch2 id=\"alpine-and-other-musl-systems\">Alpine and other musl systems\u003Ca class=\"f-doc-anchor\" href=\"#alpine-and-other-musl-systems\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>Linux with musl has binaries of its own (\u003Ccode>x86_64-unknown-linux-musl\u003C\u002Fcode>,\n\u003Ccode>aarch64-unknown-linux-musl\u003C\u002Fcode>), linked statically. The installer picks them when it finds\n\u003Ccode>\u002Flib\u002Fld-musl-*.so.1\u003C\u002Fcode> or \u003Ccode>\u002Fetc\u002Falpine-release\u003C\u002Fcode>; nothing needs to be configured. The glibc\nbinaries are linked against glibc 2.17, so they run on every maintained glibc distribution.\u003C\u002Fp>\n\u003Cp>The binary needs no system libraries and no installed fonts. With \u003Ccode>systemFonts: true\u003C\u002Fcode>, it reads\nthe font directories that fontconfig's configuration lists, else \u003Ccode>\u002Fusr\u002Fshare\u002Ffonts\u003C\u002Fcode>,\n\u003Ccode>\u002Fusr\u002Flocal\u002Fshare\u002Ffonts\u003C\u002Fcode> and \u003Ccode>~\u002F.local\u002Fshare\u002Ffonts\u003C\u002Fcode>; install the font packages you want there\n(see \u003Ca href=\"\u002Fdocs\u002Ffonts\">fonts.md\u003C\u002Fa>).\u003C\u002Fp>\n\u003Ch2 id=\"servers-without-access-to-github\">Servers without access to GitHub\u003Ca class=\"f-doc-anchor\" href=\"#servers-without-access-to-github\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>Put the files of the release somewhere the server can reach and point \u003Ccode>FAGUS_DOWNLOAD_URL\u003C\u002Fcode> at it:\na directory or a URL that holds the files under their names in the release, \u003Ccode>fagus-&lt;target&gt;\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>text\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>fagus-x86_64-unknown-linux-gnu\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>fagus-aarch64-unknown-linux-gnu\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>fagus-x86_64-unknown-linux-musl\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>fagus-aarch64-unknown-linux-musl\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>fagus-x86_64-apple-darwin\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>fagus-aarch64-apple-darwin\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>fagus-x86_64-pc-windows-msvc.exe\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>sh\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">FAGUS_DOWNLOAD_URL\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">https:\u002F\u002Fartifacts.example.com\u002Ffagus\u002F0.1.0\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> composer\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> install\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">FAGUS_DOWNLOAD_URL\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\u002Fmnt\u002Fartifacts\u002Ffagus\u002F0.1.0\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> vendor\u002Fbin\u002Ffagus-install\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>The binary is installed only if its SHA-256 is the one the package lists for its release,\nwhatever its source. \u003Ccode>FAGUS_DOWNLOAD_URL\u003C\u002Fcode> applies to the plugin, \u003Ccode>vendor\u002Fbin\u002Ffagus-install\u003C\u002Fcode> and\n\u003Ccode>php artisan fagus:install\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>\u003Ccode>vendor\u002Fbin\u002Ffagus-install\u003C\u002Fcode> takes a directory as its argument to install somewhere else than into\nthe package; name that path in \u003Ccode>FAGUS_BINARY\u003C\u002Fcode> then:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>sh\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FFA657\">vendor\u002Fbin\u002Ffagus-install\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \u002Fopt\u002Ffagus\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#8B949E\"># The fagus binary is installed at \u002Fopt\u002Ffagus\u002Ffagus.\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Ch2 id=\"use-a-binary-of-your-own\">Use a binary of your own\u003Ca class=\"f-doc-anchor\" href=\"#use-a-binary-of-your-own\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>\u003Ccode>FAGUS_BINARY\u003C\u002Fcode> names a binary that the engine uses instead of the installed one, for example one\nbuilt from source:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>sh\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FFA657\">cargo\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> build\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> --release\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -p\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> fagus-cli\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">export\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> FAGUS_BINARY\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">\u002Fpath\u002Fto\u002Ffagus\u002Ftarget\u002Frelease\u002Ffagus\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>The engine looks for the binary in this order:\u003C\u002Fp>\n\u003Col>\n\u003Cli>The \u003Ccode>binary\u003C\u002Fcode> argument of \u003Ccode>Engine\u003C\u002Fcode> (in Laravel, the \u003Ccode>binary\u003C\u002Fcode> key of \u003Ccode>config\u002Ffagus.php\u003C\u002Fcode>).\u003C\u002Fli>\n\u003Cli>\u003Ccode>FAGUS_BINARY\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>The binary the installer put into the package (\u003Ccode>vendor\u002Fnforst\u002Ffagus\u002Fphp\u002Ffagus\u002Fbin\u002Ffagus\u003C\u002Fcode>,\n\u003Ccode>fagus.exe\u003C\u002Fcode> on Windows).\u003C\u002Fli>\n\u003Cli>\u003Ccode>fagus\u003C\u002Fcode> (\u003Ccode>fagus.exe\u003C\u002Fcode>) on the \u003Ccode>PATH\u003C\u002Fcode>.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>A binary named in the first two must exist and be executable, otherwise the engine does not fall\nback but throws:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>text\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>The fagus binary `\u002Fusr\u002Flocal\u002Fbin\u002Ffagus` could not be started. It does not exist or is not executable.\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>The binary must speak the package's protocol; use the one of the same release.\u003C\u002Fp>\n\u003Cp>Under PHP-FPM the pool's environment is cleared by default (\u003Ccode>clear_env = yes\u003C\u002Fcode>), so a\n\u003Ccode>FAGUS_BINARY\u003C\u002Fcode> from the shell does not reach PHP. Set it in the pool\n(\u003Ccode>env[FAGUS_BINARY] = \u002Fusr\u002Flocal\u002Fbin\u002Ffagus\u003C\u002Fcode>) or pass the path to the engine. In Laravel,\n\u003Ccode>FAGUS_BINARY\u003C\u002Fcode> in \u003Ccode>.env\u003C\u002Fcode> works, also with a cached configuration, as it is read into\n\u003Ccode>config('fagus.binary')\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2 id=\"windows\">Windows\u003Ca class=\"f-doc-anchor\" href=\"#windows\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>The binary is \u003Ccode>fagus.exe\u003C\u002Fcode> for x64; Windows on ARM is not supported.\u003C\u002Fli>\n\u003Cli>There is no timeout: PHP cannot wait for a pipe with a time limit on Windows, so the engine\nwaits for each answer as long as it takes.\u003C\u002Fli>\n\u003Cli>A running binary is locked. Stop the processes that run it (queue workers, Octane) before\n\u003Ccode>composer update\u003C\u002Fcode> replaces it; otherwise the installer reports that it could not write the\nbinary.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"worker-processes\">Worker processes\u003Ca class=\"f-doc-anchor\" href=\"#worker-processes\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The PHP package starts the binary as a worker process with the first document and talks to it\nthrough pipes (\u003Ca href=\"\u002Fdocs\u002Fprotocol\">protocol.md\u003C\u002Fa>). The worker keeps fonts and caches warm and renders one\ndocument after another until its engine is closed or destroyed. HTML, fonts and PDFs travel\nthrough the pipes as they are, of any size.\u003C\u002Fp>\n\u003Ctable class=\"f-doc-table f-stack-table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Runtime\u003C\u002Fth>\n\u003Cth>The worker serves\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>PHP-FPM, mod_php, FrankenPHP's classic mode\u003C\u002Ftd>\n\u003Ctd data-label=\"The worker serves\">the documents of one request; the first document of each request starts it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Queue workers (\u003Ccode>queue:work\u003C\u002Fcode>, Horizon)\u003C\u002Ftd>\n\u003Ctd data-label=\"The worker serves\">every document of the queue worker process\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Octane (Swoole, RoadRunner, FrankenPHP)\u003C\u002Ftd>\n\u003Ctd data-label=\"The worker serves\">every document of the Octane worker: the Laravel integration warms the engine (\u003Ca href=\"\u002Fdocs\u002Flaravel#octane-and-frankenphp\">laravel.md\u003C\u002Fa>)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>FrankenPHP's worker mode without Laravel, long-running scripts\u003C\u002Ftd>\n\u003Ctd data-label=\"The worker serves\">every document, as long as the engine (for example \u003Ccode>Fagus::engine()\u003C\u002Fcode>) is kept\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>CLI scripts\u003C\u002Ftd>\n\u003Ctd data-label=\"The worker serves\">the documents of the script\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Each PHP process that renders has its own worker process. One worker renders one document at a\ntime, as PHP sends them one after another.\u003C\u002Fp>\n\u003Cp>\u003Ccode>Engine::close()\u003C\u002Fcode> stops the worker; the next document starts a new one, which gets the fonts of\n\u003Ccode>addFont()\u003C\u002Fcode> again. When a worker times out or exits, the engine stops it and throws an\n\u003Ccode>EngineException\u003C\u002Fcode>; the next document starts a new worker.\u003C\u002Fp>\n\u003Ch2 id=\"speed-and-memory\">Speed and memory\u003Ca class=\"f-doc-anchor\" href=\"#speed-and-memory\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>Rendering times of invoices on an Apple M3, once the worker runs, unless noted:\u003C\u002Fp>\n\u003Ctable class=\"f-doc-table f-stack-table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Document\u003C\u002Fth>\n\u003Cth>Time\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>One-page invoice, tagged\u003C\u002Ftd>\n\u003Ctd data-label=\"Time\">about 1.5 ms\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Ten-page invoice, tagged\u003C\u002Ftd>\n\u003Ctd data-label=\"Time\">about 12 ms\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>First document of a process, including the start of the worker\u003C\u002Ftd>\n\u003Ctd data-label=\"Time\">about 8 ms\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>On an Apple M2 Pro, \u003Ccode>fagus render\u003C\u002Fcode> of the repository's corpus invoices peaks at about 22 MB of resident memory\nfor the one-page invoice and 34 MB for the ten-page invoice. The macOS binary itself is about 25 MB\non disk. Large images, many fonts and long documents need more.\u003C\u002Fp>\n\u003Cp>Under PHP-FPM, every request that renders pays the start of the worker once. Where many requests\nrender PDFs, a queue worker or Octane keeps the worker running.\u003C\u002Fp>\n\u003Ch2 id=\"threads\">Threads\u003Ca class=\"f-doc-anchor\" href=\"#threads\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The binary compresses the PDF on two threads of its own while it draws the pages, which makes\nlarge documents a few percent faster. \u003Ccode>RAYON_NUM_THREADS\u003C\u002Fcode> sets how many there are:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>sh\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">RAYON_NUM_THREADS\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">1\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> php\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> artisan\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> queue:work\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>More than two gain nothing. With many workers side by side on few cores, one thread each saves\nprocessor time. The worker inherits the environment of the PHP process that starts it; under\nPHP-FPM, set the variable in the pool (\u003Ccode>env[RAYON_NUM_THREADS] = 1\u003C\u002Fcode>).\u003C\u002Fp>\n\u003Ch2 id=\"timeouts\">Timeouts\u003Ca class=\"f-doc-anchor\" href=\"#timeouts\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The engine waits up to \u003Ccode>timeout\u003C\u002Fcode> seconds (60 by default) for each answer of the worker. A worker\nthat does not answer in time is stopped, and the engine throws:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>text\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>The fagus worker did not answer within 60 seconds and was stopped.\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>php\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">new\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> Engine\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">timeout\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">120.0\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">);   \u003C\u002Fspan>\u003Cspan style=\"color:#8B949E\">\u002F\u002F in Laravel: 'timeout' => 120 in config\u002Ffagus.php\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>The limit applies to each answer, not to the whole document: time spent in your resolver\ncallback does not count. There is no timeout on Windows. For requests, keep the timeout below the\nlimits of PHP-FPM (\u003Ccode>request_terminate_timeout\u003C\u002Fcode>) and of your web server, or render long documents\nin a queue.\u003C\u002Fp>\n\u003Ch2 id=\"reproducible-pdfs\">Reproducible PDFs\u003Ca class=\"f-doc-anchor\" href=\"#reproducible-pdfs\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The same document gives the same bytes when:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>the creation date is fixed with \u003Ccode>created()\u003C\u002Fcode> (the current time otherwise),\u003C\u002Fli>\n\u003Cli>the fonts are the same, which they are with fonts from \u003Ccode>@font-face\u003C\u002Fcode>, font directories and the\nbuilt-in fonts, and not necessarily with \u003Ccode>systemFonts: true\u003C\u002Fcode>,\u003C\u002Fli>\n\u003Cli>the binary is the same release.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>php\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">$pdf \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> Fagus\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">html\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">($html)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    ->\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">created\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">new\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> DateTimeImmutable\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">'2026-11-02 12:00:00'\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">new\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> DateTimeZone\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">'UTC'\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    ->\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">render\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">();\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>Every platform prints the same PDF from the same input, so a PDF made on a Mac matches the one\nmade on a Linux server.\u003C\u002Fp>\n",[85,89,93,96,99,102,105,108,111,114,117],{"id":86,"text":87,"level":88},"install-the-binary-in-ci-and-docker-builds","Install the binary in CI and Docker builds",2,{"id":90,"text":91,"level":92},"docker","Docker",3,{"id":94,"text":95,"level":88},"alpine-and-other-musl-systems","Alpine and other musl systems",{"id":97,"text":98,"level":88},"servers-without-access-to-github","Servers without access to GitHub",{"id":100,"text":101,"level":88},"use-a-binary-of-your-own","Use a binary of your own",{"id":103,"text":104,"level":88},"windows","Windows",{"id":106,"text":107,"level":88},"worker-processes","Worker processes",{"id":109,"text":110,"level":88},"speed-and-memory","Speed and memory",{"id":112,"text":113,"level":88},"threads","Threads",{"id":115,"text":116,"level":88},"timeouts","Timeouts",{"id":118,"text":119,"level":88},"reproducible-pdfs","Reproducible PDFs","https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\u002Fedit\u002Fmain\u002Fdocs\u002Fdeployment.md","https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\u002Fblob\u002Fv0.1.0\u002Fdocs\u002Fdeployment.md","\u002Fdocs\u002Fdeployment.md",{"slug":31,"title":32},{"slug":37,"title":38}]