https://github.com/linode/linode-blockstorage-csi-driver
Container Storage Interface (CSI) Driver for Linode Block Storage
https://github.com/linode/linode-blockstorage-csi-driver
csi kubernetes linode pvc storage volume
Last synced: about 1 month ago
JSON representation
Container Storage Interface (CSI) Driver for Linode Block Storage
- Host: GitHub
- URL: https://github.com/linode/linode-blockstorage-csi-driver
- Owner: linode
- License: apache-2.0
- Created: 2018-07-17T19:38:16.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2026-05-11T15:38:03.000Z (about 1 month ago)
- Last Synced: 2026-05-11T17:31:08.146Z (about 1 month ago)
- Topics: csi, kubernetes, linode, pvc, storage, volume
- Language: Go
- Homepage:
- Size: 2.98 MB
- Stars: 77
- Watchers: 21
- Forks: 61
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-kubernetes - Linode Block Storage
README
# Linode Block Storage CSI Driver
[](https://goreportcard.com/report/github.com/linode/linode-blockstorage-csi-driver)
[](https://codecov.io/gh/linode/linode-blockstorage-csi-driver)
[](https://hub.docker.com/r/linode/linode-blockstorage-csi-driver/)
## Table of Contents
- [Overview](#overview)
- [Deployment](docs/deployment.md)
- [Requirements](docs/deployment.md#-requirements)
- [Secure a Linode API Access Token](docs/deployment.md#-secure-a-linode-api-access-token)
- [Deployment Methods](docs/deployment.md#️-deployment-methods)
- [Using Helm (Recommended)](docs/deployment.md#1-using-helm)
- [Using kubectl](docs/deployment.md#2-using-kubectl)
- [Advanced Configuration and Operational Details](docs/deployment.md#-advanced-configuration-and-operational-details)
- [Usage Examples](docs/usage.md)
- [Creating a PersistentVolumeClaim](docs/usage.md#creating-a-persistentvolumeclaim)
- [Encrypted Drives using LUKS](docs/encrypted-drives.md)
- [Adding Tags to Created Volumes](docs/volume-tags.md)
- [Topology-Aware Provisioning](docs/topology-aware-provisioning.md)
- [Development Setup](docs/development-setup.md)
- [Prerequisites](docs/development-setup.md#-prerequisites)
- [Setting Up the Local Development Environment](docs/development-setup.md#-setting-up-the-local-development-environment)
- [Building the Project](docs/development-setup.md#️-building-the-project)
- [Running Unit Tests](docs/development-setup.md#️-running-unit-tests)
- [Creating a Development Cluster](docs/development-setup.md#️-creating-a-development-cluster)
- [Running E2E Tests](docs/testing.md)
- [Contributing](docs/contributing.md)
- [Observability](docs/observability.md)
- [Metrics](docs/metrics-documentation.md)
- [How to opt-in for Metrics](docs/observability.md#steps-to-opt-in-for-the-csi-driver-metrics)
- [Tracing](docs/tracing-documentation.md)
- [How to opt-in for Tracing](docs/observability.md#steps-to-opt-in-for-tracing-in-the-csi-driver)
- [License](#license)
- [Disclaimers](#-disclaimers)
- [Community](#-join-us-on-slack)
## 📚 Overview
The Container Storage Interface ([CSI](https://github.com/container-storage-interface/spec)) Driver for Linode Block Storage enables container orchestrators such as Kubernetes to manage the lifecycle of persistent storage claims.
For more information about Kubernetes CSI, refer to the [Kubernetes CSI](https://kubernetes-csi.github.io/docs/introduction.html) and [CSI Spec](https://github.com/container-storage-interface/spec/) repositories.
## ⚠️ Disclaimers
- **Volume Size Constraints**:
- Requests for Persistent Volumes with a require_size less than the Linode minimum Block Storage size will be fulfilled with a Linode Block Storage volume of the minimum size (currently 10Gi) in accordance with the CSI specification.
- The upper-limit size constraint (`limit_bytes`) will also be honored, so the size of Linode Block Storage volumes provisioned will not exceed this parameter.
- **Volume Attachment Persistence**: Block storage volume attachments are no longer persisted across reboots to support a higher number of attachments on larger instances.
_For more details, refer to the [CSI specification](https://github.com/container-storage-interface/spec/blob/v1.0.0/spec.md#createvolume)._
## 💬 Join Us on Slack
- **General Help/Discussion**: [Kubernetes Slack - #linode](https://kubernetes.slack.com/messages/CD4B15LUR)
- **Development/Debugging**: [Gopher's Slack - #linodego](https://gophers.slack.com/messages/CAG93EB2S)
## License
This project is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full license text.