# edh-docs

> Earth Data Hub (EDH) is a Destination Earth (DestinE) service, operated by B-Open, that provides petabytes of analysis-ready, cloud-optimised (ARCO) Earth data, including ERA5, ERA5-Land, CMIP6, the Climate Adaptation Digital Twin (Climate DT), Copernicus DEM and Sentinel-1 ARD. EDH is built entirely on open standards: datasets are Zarr v3 stores streamed over HTTPS and discovered through a STAC catalogue, so any Zarr-capable tool works without a bespoke SDK. Python with Xarray (zarr-python 3 or later) is recommended.
> 
> Main features and endpoints:
> 
> - STAC catalogue: https://earthdatahub.destine.eu/api/stac/v1 (public, no API key). Each dataset is a STAC item whose `data` asset holds the dataset URL and the arguments to open it with Xarray. Interactive API reference: https://earthdatahub.destine.eu/api/stac/v1/api.html
> - Zarr over HTTPS: datasets are served from https://data.earthdatahub.destine.eu as `<collection>/<dataset>-v<N>.zarr`, where a higher version number is newer. Take dataset URLs from STAC or the EDH website rather than guessing them.
> - Authentication: a free API key from a DestinE Platform account (https://earthdatahub.destine.eu/quota-api-keys), sent as HTTP basic auth (user `edh`), a bearer token, or through a .netrc file. A public test dataset needs no key. https://api.earthdatahub.destine.eu is an alternative data host.
> - Upgraded access: restricted datasets, such as the Climate DT collection, also require DestinE upgraded access.
> - Quotas: 500,000 HTTP requests per user per month, where each Zarr chunk read counts as one request. Local caching with fsspec reduces repeated requests.
> - Chunking: datasets are map-optimised or time series-optimised, and some are published in both layouts.
> - Notebooks: Jupyter notebooks with examples, use cases and best practices, some of which run in the browser in Insula Code Lab.
> 
> The Data Access page covers setup, authentication, quotas, caching and the full STAC and Zarr API reference. Troubleshooting covers common errors (401, 403, 426, 429 and Zarr v3 incompatibilities). Every page is available as Markdown, and llms-full.txt contains the complete documentation in one file.


2026, European Union

## Pages in this subsection

- [FAQs](https://earthdatahub.destine.eu/docs/help/faqs.md): Earth Data Hub FAQs: what the version number (v0, v1, …) in a dataset URL means, which version to use, and how often datasets are updated (monthly datasets by the third week of each month).
- [Troubleshooting](https://earthdatahub.destine.eu/docs/help/troubleshooting.md): Fixes for common Earth Data Hub errors when opening datasets: Zarr v3 incompatibilities, 401 Unauthorized, 403 Forbidden (restricted datasets), 426 Upgrade Required (API key/domain mismatch), 429 Too Many Requests (exhausted quota), and misleading errors such as GroupNotFoundError when using the local cache.

## Optional

- [Top-level llms.txt](https://earthdatahub.destine.eu/docs/llms.txt): Complete documentation index.