Skip to contents

Install precompiled GDAL runtime

Source: R/gdal_runtime.R
install_gdal_runtime.Rd

Installs the GDAL runtime into gdal_home from one of:

Usage

install_gdal_runtime(
  repo = "jimbrig/gdalraster.windows",
  tag = "latest",
  asset_pattern = "gdal-(bundle|ucrt64)-.*\\.zip$",
  gdal_home = default_gdal_home(),
  overwrite = FALSE,
  local_zip = NULL,
  fallback_zip = NULL
)

Arguments

repo

GitHub repo slug, e.g. "jimbrig/gdalraster.windows".

tag

Release tag or "latest".

asset_pattern

Regex used to select the release asset.

gdal_home

Destination GDAL home directory.

overwrite

Whether to replace existing gdal_home.

local_zip

Optional local GDAL runtime zip to install directly.

fallback_zip

Optional fallback zip path used when release download fails. When NULL (default), a vendored zip at inst/extdata/gdal-ucrt64-fallback.zip is used if present; none ships with the package, so by default no fallback is attempted.

Value

Invisibly returns installed GDAL home path.

Details

  • local_zip (highest precedence),

  • GitHub release asset lookup/download,

  • fallback_zip when release lookup/download fails.

The selected zip must contain a GDAL root with bin/libgdal-*.dll.

Offline / air-gapped installation

On machines without network access, download the release asset manually from https://github.com/jimbrig/gdalraster.windows/releases, transfer it to the target machine, and install directly:

gdalraster.windows::install_gdal_runtime(
  local_zip = "C:/Downloads/gdal-ucrt64-v3.13.1-windows-x64.zip"
)

Note that no fallback zip is shipped with the package (a full runtime bundle is too large to vendor), so the fallback path only applies when you provide a fallback_zip yourself.