apache/opendal

Apache OpenDAL: One Layer, All Storage.

5,374

stars

4,550

commits

Rust

primary language

Sep 11, 2026

updated

opendal.apache.org
azblob
gcs
hacktoberfest
redis
rust
s3
storage

README

Apache OpenDAL™: One Layer, All Storage.

GitHub Discussions Discord DeepWiki

Apache OpenDAL™ (/ˈoʊ.pən.dæl/, pronounced "OH-puhn-dal") is an Open Data Access Layer that gives every language a unified way to access object storage, file storage, cloud SaaS, databases, protocols, and key-value services.

Apache OpenDAL™ is guided by its vision of One Layer, All Storage and its core principles: Open Community, Solid Foundation, Fast Access, Object Storage First, and Extensible Architecture. Read the explained vision at OpenDAL Vision.

OpenDAL Architecture

At a Glance

  • Project: Apache OpenDAL™
  • Vision: One Layer, All Storage
  • Core package: Rust crate opendal
  • Main abstraction: Operator
  • Extension points: language bindings, layers, and services
  • Common layers: retry, timeout, logging, tracing, metrics, throttling, and concurrency control
  • Access targets: object storage, file systems, cloud SaaS, databases, protocols, and key-value services

Why OpenDAL

Apache OpenDAL™ turns the vision of One Layer, All Storage into a practical data access layer for applications, libraries, and data systems.

  • Zero-cost core: built in Rust with composable services and layers, so applications only enable the backends and capabilities they use.
  • Production-ready access: add retry, timeout, logging, tracing, metrics, throttling, and concurrency limits through reusable layers.
  • One API, all storage: access object storage, file systems, cloud SaaS, databases, protocols, and key-value services through the same interface.
  • Open and extensible: add new services, layers, and language bindings while keeping the same unified access model.

Choose Your Language

Start with the binding for your application runtime. Each binding provides access to the same OpenDAL service model while following its language ecosystem.

Note: Each binding has its own independent version number, which may differ from the Rust core version. When checking for updates or compatibility, always refer to the specific binding's version rather than the core version.

Choose Your Layers

Add layers when your application needs cross-service behavior such as retries, timeouts, observability, or traffic control.

Retry icon
RetryLayer
Retry temporary failures.
Timeout icon
TimeoutLayer
Bound slow or hanging operations.
Logging icon
LoggingLayer
Emit structured operation logs.
Tracing icon
TracingLayer
Trace requests across systems.
Metrics icon
MetricsLayer
Export operation metrics.
Prometheus icon
PrometheusLayer
Expose Prometheus metrics.
OpenTelemetry icon
OtelMetricsLayer
Export OpenTelemetry metrics.
Traffic control icon
Traffic Control
ThrottleLayer · ConcurrentLimitLayer
Content type icon
MimeGuessLayer
Infer Content-Type from paths.
Route icon
RouteLayer
Route operations by path.
Cache icon
FoyerLayer
Add hybrid cache behavior.
Layers icon
All Layers
Explore the full layer list.

Explore all available layers in the layers documentation.

Choose Your Services

Pick the storage services that your application needs. See the full OpenDAL service configuration docs in the services documentation.

Examples

See examples for runnable usage examples.

Documentation

Contribute

OpenDAL is an active open-source project. We are always open to people who want to use it or contribute to it. Here are some ways to go.

Branding

The first and most prominent mentions must use the full form: Apache OpenDAL™ of the name for any individual usage (webpage, handout, slides, etc.) Depending on the context and writing style, you should use the full form of the name sufficiently often to ensure that readers clearly understand the association of both the OpenDAL project and the OpenDAL software product to the ASF as the parent organization.

For more details, see the Apache Product Name Usage Guide.

License and Trademarks

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0

Apache OpenDAL, OpenDAL, and Apache are either registered trademarks or trademarks of the Apache Software Foundation.

Contributors

(top 30 of 395)

Xuanwo

1,728 commits

dependabot[bot]

285 commits

tisonkun

206 commits

suyanhanx

204 commits

apache/opendal

Apache OpenDAL: One Layer, All Storage.

5,374

stars

4,550

commits

Rust

primary language

Sep 11, 2026

updated

opendal.apache.org
azblob
gcs
hacktoberfest
redis
rust
s3
storage

README

Apache OpenDAL™: One Layer, All Storage.

GitHub Discussions Discord DeepWiki

Apache OpenDAL™ (/ˈoʊ.pən.dæl/, pronounced "OH-puhn-dal") is an Open Data Access Layer that gives every language a unified way to access object storage, file storage, cloud SaaS, databases, protocols, and key-value services.

Apache OpenDAL™ is guided by its vision of One Layer, All Storage and its core principles: Open Community, Solid Foundation, Fast Access, Object Storage First, and Extensible Architecture. Read the explained vision at OpenDAL Vision.

OpenDAL Architecture

At a Glance

  • Project: Apache OpenDAL™
  • Vision: One Layer, All Storage
  • Core package: Rust crate opendal
  • Main abstraction: Operator
  • Extension points: language bindings, layers, and services
  • Common layers: retry, timeout, logging, tracing, metrics, throttling, and concurrency control
  • Access targets: object storage, file systems, cloud SaaS, databases, protocols, and key-value services

Why OpenDAL

Apache OpenDAL™ turns the vision of One Layer, All Storage into a practical data access layer for applications, libraries, and data systems.

  • Zero-cost core: built in Rust with composable services and layers, so applications only enable the backends and capabilities they use.
  • Production-ready access: add retry, timeout, logging, tracing, metrics, throttling, and concurrency limits through reusable layers.
  • One API, all storage: access object storage, file systems, cloud SaaS, databases, protocols, and key-value services through the same interface.
  • Open and extensible: add new services, layers, and language bindings while keeping the same unified access model.

Choose Your Language

Start with the binding for your application runtime. Each binding provides access to the same OpenDAL service model while following its language ecosystem.

Note: Each binding has its own independent version number, which may differ from the Rust core version. When checking for updates or compatibility, always refer to the specific binding's version rather than the core version.

Choose Your Layers

Add layers when your application needs cross-service behavior such as retries, timeouts, observability, or traffic control.

Retry icon
RetryLayer
Retry temporary failures.
Timeout icon
TimeoutLayer
Bound slow or hanging operations.
Logging icon
LoggingLayer
Emit structured operation logs.
Tracing icon
TracingLayer
Trace requests across systems.
Metrics icon
MetricsLayer
Export operation metrics.
Prometheus icon
PrometheusLayer
Expose Prometheus metrics.
OpenTelemetry icon
OtelMetricsLayer
Export OpenTelemetry metrics.
Traffic control icon
Traffic Control
ThrottleLayer · ConcurrentLimitLayer
Content type icon
MimeGuessLayer
Infer Content-Type from paths.
Route icon
RouteLayer
Route operations by path.
Cache icon
FoyerLayer
Add hybrid cache behavior.
Layers icon
All Layers
Explore the full layer list.

Explore all available layers in the layers documentation.

Choose Your Services

Pick the storage services that your application needs. See the full OpenDAL service configuration docs in the services documentation.

Examples

See examples for runnable usage examples.

Documentation

Contribute

OpenDAL is an active open-source project. We are always open to people who want to use it or contribute to it. Here are some ways to go.

Branding

The first and most prominent mentions must use the full form: Apache OpenDAL™ of the name for any individual usage (webpage, handout, slides, etc.) Depending on the context and writing style, you should use the full form of the name sufficiently often to ensure that readers clearly understand the association of both the OpenDAL project and the OpenDAL software product to the ASF as the parent organization.

For more details, see the Apache Product Name Usage Guide.

License and Trademarks

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0

Apache OpenDAL, OpenDAL, and Apache are either registered trademarks or trademarks of the Apache Software Foundation.

Contributors

(top 30 of 395)

Xuanwo

1,728 commits

dependabot[bot]

285 commits

tisonkun

206 commits

suyanhanx

204 commits

Languages

Rust

69.8%

C#

5.8%

Java

4.2%

Go

3.8%

C++

3.5%

JavaScript

3.1%

Python

2.7%

C

1.2%

Dart

1.0%