bino setup
bino relies on Chrome headless shell and a template engine to render PDFs.
Use bino setup to download and configure these dependencies.
bino setup [flags]Template engine flags
Section titled “Template engine flags”--template-engine– download or update the bn-template-engine.--engine-version– specific template engine version to download (default: latest). For examplev0.37.0.
General flags
Section titled “General flags”--dry-run– show what would be installed without actually downloading.--quiet– suppress verbose installer output.
Examples
Section titled “Examples”Install Chrome headless shell and template engine:
bino setupInstall the template engine only (latest version):
bino setup --template-engineInstall a specific template engine version:
bino setup --template-engine --engine-version v0.37.0Preview what would be installed without downloading:
bino setup --dry-runChrome headless shell
Section titled “Chrome headless shell”Chrome headless shell (chrome-headless-shell) is a lightweight Chrome binary purpose-built for headless rendering. It is downloaded from Google’s Chrome for Testing infrastructure and cached in ~/.bino/chrome-headless-shell/.
If you need to use a custom Chrome or Chromium installation, set the CHROME_PATH environment variable to point to the binary. This takes priority over the cached version.
Template engine
Section titled “Template engine”The template engine (bn-template-engine) is a JavaScript runtime used to render HTML templates. It is downloaded separately from Chrome headless shell and cached in ~/.bino/cdn/bn-template-engine/.
Multiple versions can be installed side by side. By default, bino uses the latest locally installed version unless a specific version is pinned in bino.toml via the engine-version field. See Project configuration for more details.
Troubleshooting
Section titled “Troubleshooting”If builds fail with rendering or browser errors, rerun this command and verify that your environment has network and disk access.