Skip to content
GitHub

bino setup

bino relies on a browser runtime and template engine to render PDFs. Use bino setup to download and configure these dependencies.

bino setup [flags]
  • --browser – one or more browsers to install (default: chromium). Repeat to add firefox, webkit, etc.
  • --driver-dir – custom directory for the browser driver cache.
  • --template-engine – download or update the bn-template-engine.
  • --engine-version – specific template engine version to download (default: latest). For example v0.37.0.
  • --dry-run – show what would be installed without actually downloading.
  • --quiet – suppress verbose installer output.

Install Chromium only:

bino setup --browser chromium

Install multiple browsers:

bino setup --browser chromium --browser firefox

Install the template engine (latest version):

bino setup --template-engine

Install a specific template engine version:

bino setup --template-engine --engine-version v0.37.0

Preview what would be installed without downloading:

bino setup --dry-run

The template engine (bn-template-engine) is a JavaScript runtime used to render HTML templates. It is downloaded separately from the browser runtimes and cached in ~/.bn/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.

If builds fail with rendering or browser errors, rerun this command and verify that your environment has network and disk access.