Skip to content

Installation

gotiler ships as a self-contained archive: one executable plus a share folder holding the PROJ data it uses to transform coordinates. There is no runtime or shared library to set up.

On Linux (x86_64 or ARM64), macOS (Apple Silicon, macOS 12 or later) and 64-bit Windows, one command installs the latest release:

Terminal window
curl -fsSL https://github.com/mfbonfigli/gotiler/releases/latest/download/install.sh | sh

The script installs gotiler in ~/.local/share/gotiler and links the executable from ~/.local/bin. If that folder is not on your PATH, it prints the line to add to your shell profile. It needs only tools that Linux distributions ship: curl or wget, tar, gzip, awk and a SHA-256 tool.

Both scripts check the download against the release’s SHA256SUMS file and need no administrator rights. Then check that gotiler runs:

Terminal window
gotiler version

Run the install command again: it replaces the installed version and keeps the files you added to its share folder, such as datum grids.

The scripts read these environment variables:

Variable Default Sets
GOTILER_VERSION The latest release The release to install, for example v3.1.0
GOTILER_INSTALL_DIR ~/.local/share/gotiler, or %LOCALAPPDATA%\Programs\gotiler on Windows The install folder
GOTILER_BIN_DIR ~/.local/bin The folder of the gotiler link, on Linux and macOS

They never replace a folder they did not install: if the install folder already holds other files, they stop and ask you to pick another one. To install a given release:

Terminal window
curl -fsSL https://github.com/mfbonfigli/gotiler/releases/latest/download/install.sh | GOTILER_VERSION=v3.1.0 sh

Delete the install folder and the link to the executable:

Terminal window
rm -rf ~/.local/share/gotiler ~/.local/bin/gotiler

Each GitHub release has an archive per platform:

Platform Archive
Linux x86_64 gotiler-linux-amd64-<version>.tar.gz
Linux ARM64 gotiler-linux-arm64-<version>.tar.gz
macOS Apple Silicon gotiler-darwin-arm64-<version>.tar.gz
Windows x86_64 gotiler-windows-amd64-<version>.zip
  1. Download the archive for your CPU, gotiler-linux-amd64-<version>.tar.gz or gotiler-linux-arm64-<version>.tar.gz, from the latest release.

  2. Extract it, into a gotiler-linux-amd64-<version> folder:

    Terminal window
    tar -xzf gotiler-linux-amd64-<version>.tar.gz
  3. Check that gotiler runs:

    Terminal window
    ./gotiler-linux-amd64-<version>/gotiler version

The install scripts check their download on their own. For a manual download, compare the archive’s checksum with the one listed in the release’s SHA256SUMS file:

Terminal window
# run in the folder holding the archive and SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing

Every archive and install script also has a signed build provenance attestation, which proves that the repository’s release workflow built it. To check one with the GitHub CLI:

Terminal window
gh attestation verify gotiler-linux-amd64-<version>.tar.gz --repo mfbonfigli/gotiler

The bundled PROJ data covers the common transformations. For high-precision datum conversions, including vertical ones, download the grids you need from the PROJ CDN into the share folder. With the install script, that is ~/.local/share/gotiler/share on Linux and macOS, and %LOCALAPPDATA%\Programs\gotiler\share on Windows.

While processing, gotiler keeps temporary working files in a tmp folder inside the output folder, so the output drive needs extra free disk space. The space is released at the end of processing.

gotiler can also be built from source with Go, CGO and PROJ: see Development for the setup on Linux, macOS and Windows.