.. _download:

================================================================================
Download
================================================================================

.. only:: html

    .. contents::
       :depth: 3
       :backlinks: none

The GDAL project distributes GDAL as source code and :ref:`Containers` only. :ref:`Binaries` produced by others are available for a variety of platforms and package managers.

Source Code
-----------

Current Release
...............

* **2025-12-18** `gdal-3.12.1.tar.gz`_ `3.12.1 Release Notes`_ (`3.12.1 md5`_, `3.12.1 sig`_)

.. _`3.12.1 Release Notes`: https://github.com/OSGeo/gdal/blob/v3.12.1/NEWS.md
.. _`gdal-3.12.1.tar.gz`: https://github.com/OSGeo/gdal/releases/download/v3.12.1/gdal-3.12.1.tar.gz
.. _`3.12.1 md5`: https://github.com/OSGeo/gdal/releases/download/v3.12.1/gdal-3.12.1.tar.gz.md5
.. _`3.12.1 sig`: https://github.com/OSGeo/gdal/releases/download/v3.12.1/gdal-3.12.1.tar.gz.sig

The GPG signing key is:

::

    -----BEGIN PGP PUBLIC KEY BLOCK-----

    mQINBGjlDXoBEACjbYUouwHnW+X/xK51AfwN1vTrJn+pZziGGLobD4Jfs4gU4PwQ
    dEw1bFj6tsgBrJ7hrKmcyd0bBQiKU1FTYy+tOu768t9qlC7HC3JfRBACrGn3Svz4
    evinQkq5GGcZ1FkJhRKgEIxJLGppG7O45XEFYdcbCkLqC8uyu2+PbY2SYXlzlKs8
    DLiAwqX670eZ78pDtynJj81CRowSqyNBOzaltR6OLCsYZrYzAYYtBqSiifKoIpm/
    sV4VRvUuWaaUNNMPPRLt+mV+iIYm8cKLH2uyozZWIfOSck7I30fGIuuUhulc41bi
    3WNV+QtOepPyuMolab8JNbaRJXAFxQ5Q2k5ZyzXvpuAEqwrhaFIroc7LvkQ4RLlT
    r6BkFUzvCCjRWG5jCFA0CjvvvYG9DPSUKdSaD2Vxfor/cwSRqnPYwRauFMuST57H
    exrLYJZqfeZuqV2mlI8wVvh3tO9oC/pGmggV3B1KxYvzj2I/nQ/bnugveEvD005j
    EcfSlmAPWcuily+rgB9xqed0tZwG0A9fjY/gveqxLVE41EIoAfkdeRl+KVOqEEYk
    cyiJQdFKBuGxemEP2cfDnROUawp+1XXEuA1MGkLvB+6nNIp1e+mhUtWfDY70MEz1
    l7J49MUZBfPM3vy63t7ihlPLIP9IUcO9j9rfy1iW8t86qG3CnZE/rsnVZwARAQAB
    tCRHREFMIFJlbGVhc2UgQm90IDxnZGFsb3JnQGdtYWlsLmNvbT6JAlQEEwEKAD4W
    IQR7Ew6VW0TYfM4nZfDb2B/1LsKkKgUCaOUNegIbAwUJA8JnAAULCQgHAgYVCgkI
    CwIEFgIDAQIeAQIXgAAKCRDb2B/1LsKkKpY+D/9hVR9JIQNT3So4fg/fQx36azSf
    kVzO4nS0lZhSxR4/Xig5Zqq8EOFk7ipWwb4hhivPi7yR49BhVSQbHo36+jNbC5k/
    jDMsZ+9CNzUjp1XSH/v06mcdSD4LB4vSvHBfLjDdV7OoOGnExkEyqBcoje53tW6p
    tKQGwqZ3ilZs75GkLO1UC3DNQ9VpVc7lk1Cv+npto86A6CWMAC7q+n540wC/oTj7
    APn6dz1S0LAPWR9v0aBoLMoRP9YiRQSmQmyQsKe3HJd4c7hSdWyST/PIMvPZawpP
    BYG+JRRuRoWm6zjJIWnvqj9IZeFkQv1fKqYHKW86aITTqGGF6kcq83mf2XH26KQR
    mu8ArI5aLULmpKA67p2RXxyPdoSNiaiP8UuWQ18rnEA/Hedz2sgBYSvjeYYziTRm
    wgiRbts4MjB5pj+JGKtX7FEL6HuPDVnMYGc8n8bO8qiKctuYMwBM/KRE+2e3zx0m
    m5YXjjCSvBiTLYNhvrrQ5pxiUK5xiAH0G/MzPXjJToJzLrHn0vqRVHXs9F8d9zLe
    o6E4S8VVgyJ9zdXkYtj9nyL9jb00K+jj/g4avpnOKTuIgpsTR2ntxWz2liWU6Saz
    03Vrd9mVwgU7NBnYAMXOg54eYwhyWkGvbFHvCK6ijL1+SaAkN9mVs5VTJMpGiJ9s
    qj7DbIY0GwZQMVSvxQ==
    =FY/p
    -----END PGP PUBLIC KEY BLOCK-----


Past Releases
.............

.. only:: html

    Links to :ref:`download_past` are also available.

.. only:: not html

    Links to `past releases <https://gdal.org/en/latest/download_past.html>`__ are also available.

.. _source:

Development Source
..................

The main repository for GDAL is located on GitHub at
https://github.com/OSGeo/GDAL.

You can obtain a copy of the active source code by issuing the following
command

::

    git clone https://github.com/OSGeo/GDAL.git


Additional information is available about :ref:`build_requirements` and :ref:`building_from_source`.

Maintenance policy
..................

The GDAL upstream team only maintains the branch on which the latest release has
been done, with bugfixes releases issued roughly every 2 months.
So, for example, during the development phase of GDAL 3.10.0, GDAL 3.9.x bugfixes
releases are done based on the release/3.9 branch, but not older branches (GDAL 3.8.x or older).

.. _binaries:

Binaries
------------------------------------------------------------------------------

In this section we list a number of the binary distributions of GDAL
all of which should have fully reproducible open source build recipes.

Note that the maintainers of those distributions are generally not the maintainers
of the GDAL sources, so please report any issue specific to those builds through
their own support channels.

Windows
................................................................................

Windows builds are available via `Conda Forge`_ (64-bit only). See the
:ref:`conda` or :ref:`pixi` section for more detailed information. GDAL is also distributed
by `GISInternals`_ and `OSGeo4W`_ and through the `NuGet`_ and :ref:`vcpkg` package managers.

.. _`Conda Forge`: https://anaconda.org/conda-forge/gdal
.. _`GISInternals`: https://www.gisinternals.com/index.html
.. _`OSGeo4W`: https://trac.osgeo.org/osgeo4w/
.. _`NuGet`: https://www.nuget.org/packages?q=GDAL

Linux
................................................................................

Packages are available for `Debian`_, `Alpine`_, `Fedora`_, and other distributions.

.. _`Debian`: https://tracker.debian.org/pkg/gdal
.. _`Alpine`: https://pkgs.alpinelinux.org/package/edge/community/x86/gdal
.. _`Fedora`: https://packages.fedoraproject.org/pkgs/gdal/


Mac OS
......

GDAL packages are available on `Homebrew`_.

.. _`Homebrew`: https://formulae.brew.sh/formula/gdal


Android
.......

GDAL can be installed using :ref:`vcpkg`. You may also refer to `vcpkg Android support <https://learn.microsoft.com/en-us/vcpkg/users/platforms/android>`__ for general instructions.

For example to install default configuration for the ``arm64-android`` target:

.. code-block:: shell

    git clone https://github.com/Microsoft/vcpkg.git
    cd vcpkg
    ./bootstrap-vcpkg.sh  # ./bootstrap-vcpkg.bat for Windows
    ./vcpkg integrate install
    export ANDROID_NDK_HOME=/path/to/android_ndk_home  # to adapt
    ./vcpkg search gdal --featurepackages  # list optional features
    ./vcpkg install gdal:arm64-android  # install with default configuration
    ./vcpkg install gdal[poppler,netcdf]:arm64-android  # install with Poppler and netdf support


Cross-Platform Package Managers
...............................

.. _conda:

Conda
^^^^^

`Conda <https://anaconda.org>`__ can be used on multiple platforms (Windows, macOS, and Linux) to
install software packages and manage environments. Conda packages for GDAL are
available through `conda-forge <https://anaconda.org/conda-forge/gdal>`__.

.. only:: html

    Latest version: |Conda badge|

    .. |Conda badge| image:: https://anaconda.org/conda-forge/gdal/badges/version.svg
        :target: https://anaconda.org/conda-forge/gdal

::

    conda install [-c channel] [package...]

GDAL is available as several subpackages:

- ``gdal``: Python bindings and Python utilities (depends on libgdal-core)
- ``libgdal``: meta-package gathering all below libgdal-* packages (except libgdal-arrow-parquet)
- ``libgdal-arrow-parquet``: :ref:`vector.arrow` and :ref:`vector.parquet` drivers as a plugin (depends on libgdal-core)
- ``libgdal-avif``: :ref:`raster.avif` driver as a plugin (depends on libgdal-core, available since GDAL 3.10.0)
- ``libgdal-core``: core library and C++ utilities, with a number of builtin drivers (available since GDAL 3.9.1)
- ``libgdal-fits``: :ref:`raster.fits` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-grib``: :ref:`raster.grib` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-hdf4``: :ref:`raster.hdf4` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-hdf5``: :ref:`raster.hdf5` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-heif``: :ref:`raster.heif` driver as a plugin (depends on libgdal-core, available since GDAL 3.10.0)
- ``libgdal-jp2openjpeg``: :ref:`raster.jp2openjpeg` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-kea``: :ref:`raster.kea` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-netcdf``: :ref:`raster.netcdf` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-pdf``: :ref:`raster.pdf` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-postgisraster``: :ref:`raster.postgisraster` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-pg``: :ref:`vector.pg` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-tiledb``: :ref:`raster.tiledb` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)
- ``libgdal-xls``: :ref:`vector.xls` driver as a plugin (depends on libgdal-core, available since GDAL 3.9.1)


To install the ``gdal`` package (Python bindings and utilities), and ``libgdal-core``:

::

    conda install -c conda-forge gdal


To install the ``libgdal`` meta-package with all available drivers, but libgdal-arrow-parquet:

::

    conda install -c conda-forge libgdal


To install the Arrow and Parquet drivers as plugins:

::

    conda install -c conda-forge libgdal-arrow-parquet


GDAL master Conda builds
~~~~~~~~~~~~~~~~~~~~~~~~

GDAL master builds are available in the `gdal-master <https://anaconda.org/gdal-master/gdal>`__
channel. They are based on dependencies from the ``conda-forge`` channel. The latest master
build can be installed with the following command:

::

    conda install -c gdal-master -c conda-forge gdal-master::gdal

As with released versions of GDAL, additional drivers can be installed using ``gdal-master::libgdal-{driver_name}``.

If you already have a GDAL master build installed in an environment, you can update it to the latest master version using the commands below.
GDAL subpackages may need to be updated individually, because the master version numbers (e.g. ``3.12.99``) do not change with every nightly build.

::

    # check currently installed GDAL components and versions
    conda list gdal
    gdal --version
    # update GDAL
    conda install -c gdal-master gdal --force-reinstall --yes
    # update libgdal-core to the latest master build
    conda install -c gdal-master libgdal-core --force-reinstall --yes
    gdal --version

.. _pixi:

pixi
^^^^

`Pixi <https://pixi.sh/latest/>`__  is a package management tool for developers. It allows the developer
to install libraries and applications in a reproducible way. Packages for GDAL are
available through the `conda-forge <https://anaconda.org/conda-forge/gdal>`__ channel.

If you want to be able to use GDAL as part of a project:

::

    pixi init name-of-project
    cd name-of-project
    pixi add gdal libgdal-core
    pixi add libgdal-arrow-parquet # if you need the Arrow and Parquet drivers
    pixi shell

Pixi supports using tools like GDAL and OGR globally, similar to conda's base environment, without having to use an activate command:

::

    pixi global install gdal libgdal-core
    pixi global install libgdal-arrow-parquet # if you need the Arrow and Parquet drivers

.. _vcpkg:

vcpkg
^^^^^

The GDAL port in the `vcpkg <https://github.com/Microsoft/vcpkg>`__ dependency manager is kept up to date by Microsoft team members and community contributors.
You can download and install GDAL using the vcpkg as follows:

.. code-block:: shell

    git clone https://github.com/Microsoft/vcpkg.git
    cd vcpkg
    ./bootstrap-vcpkg.sh  # ./bootstrap-vcpkg.bat for Windows
    ./vcpkg integrate install
    ./vcpkg search gdal --featurepackages  # list optional features
    ./vcpkg install gdal  # install with default configuration
    ./vcpkg install gdal[poppler,netcdf]  # install with Poppler and netdf support

If the version is out of date, please `create an issue or pull request <https://github.com/Microsoft/vcpkg>`__ on the vcpkg repository.

Spack
^^^^^

Spack is a package management tool designed to support multiple versions and
configurations of software on a wide variety of platforms and environments.
It was designed for large supercomputing centers. Spack builds packages from
sources, and allows tweaking their configurations.

You can find information about GDAL in Spack at
https://packages.spack.io/package.html?name=gdal

For the default GDAL build with a reduced number of drivers:

::

    git clone -c feature.manyFiles=true https://github.com/spack/spack.git
    cd spack/bin
    ./spack install gdal

For a build with netcdf driver enabled:

::

    ./spack install gdal +netcdf


.. _containers:

Containers
----------

Docker images with nightly builds of GDAL master and tagged releases are available at
`GitHub Container registry <https://github.com/OSGeo/gdal/pkgs/container/gdal>`_.

Information on the content of the different configurations can be found at
`https://github.com/OSGeo/gdal/tree/master/docker <https://github.com/OSGeo/gdal/tree/master/docker>`_.


Documentation
-------------

|offline-download|
