Cloud Optimized GeoTIFF (COG) creation and validation plugin for Rasterio.

Cloud Optimized GeoTIFF

This plugin aims to facilitate the creation and validation of Cloud Optimized
GeoTIFF (COG or COGEO). While it respects the
COG specifications, this plugin also
enforces several features:

  • Internal overviews (User can remove overview with option --overview-level 0)
  • Internal tiles (default profiles have 512x512 internal tiles)

Important: in GDAL 3.1 a new COG driver has been added (doc, discussion), starting with rio-cogeo version 2.2, --use-cog-driver option was added to create COG using the COG driver.


$ pip install -U pip
$ pip install rio-cogeo

Or install from source:

$ pip install -U pip
$ pip install git+

GDAL Version

It is recommended to use GDAL > 2.3.2. Previous versions might not be able to
create proper COGs (ref:

More info in