{"id":13581218,"url":"https://github.com/piraeusdatastore/linstor-csi","last_synced_at":"2026-01-16T15:27:54.866Z","repository":{"id":37962159,"uuid":"161251459","full_name":"piraeusdatastore/linstor-csi","owner":"piraeusdatastore","description":"CSI plugin for LINSTOR","archived":false,"fork":false,"pushed_at":"2026-01-12T08:44:42.000Z","size":6607,"stargazers_count":123,"open_issues_count":30,"forks_count":29,"subscribers_count":12,"default_branch":"master","last_synced_at":"2026-01-12T18:10:59.245Z","etag":null,"topics":["csi","kubernetes","linstor","persistent-storage","sds"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/piraeusdatastore.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-12-10T23:47:59.000Z","updated_at":"2026-01-12T08:44:45.000Z","dependencies_parsed_at":"2023-11-07T09:26:35.430Z","dependency_job_id":"4b69fa2c-ad03-45f1-b2bc-64be0ebbf9a6","html_url":"https://github.com/piraeusdatastore/linstor-csi","commit_stats":null,"previous_names":["linbit/linstor-csi"],"tags_count":81,"template":false,"template_full_name":null,"purl":"pkg:github/piraeusdatastore/linstor-csi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piraeusdatastore%2Flinstor-csi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piraeusdatastore%2Flinstor-csi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piraeusdatastore%2Flinstor-csi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piraeusdatastore%2Flinstor-csi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/piraeusdatastore","download_url":"https://codeload.github.com/piraeusdatastore/linstor-csi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/piraeusdatastore%2Flinstor-csi/sbom","scorecard":{"id":590391,"data":{"date":"2025-08-11","repo":{"name":"github.com/piraeusdatastore/linstor-csi","commit":"e2cd2c9fe1ce716ae4cdffc4681ebc0c84bfb9f0"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5.3,"checks":[{"name":"Code-Review","score":7,"reason":"Found 7/9 approved changesets -- score normalized to 7","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":10,"reason":"21 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/lints.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Warn: no topLevel permission defined: .github/workflows/tests.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lints.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/lints.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lints.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/lints.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lints.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/lints.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lints.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/lints.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/lints.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/lints.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/lints.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/lints.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/release.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/release.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/tests.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/piraeusdatastore/linstor-csi/tests.yml/master?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1","Warn: containerImage not pinned by hash: Dockerfile:19","Warn: containerImage not pinned by hash: Dockerfile:26: pin your Docker image by updating debian:bookworm-slim to debian:bookworm-slim@sha256:b1a741487078b369e78119849663d7f1a5341ef2768798f7b7406c4240f86aef","Info:   0 out of   8 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   7 third-party GitHubAction dependencies pinned","Info:   0 out of   3 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.8.1 not signed: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/227396308","Warn: release artifact v1.8.0 not signed: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/225792889","Warn: release artifact v1.7.1 not signed: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/205289332","Warn: release artifact v1.7.0 not signed: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/200102086","Warn: release artifact v1.6.5 not signed: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/199789100","Warn: release artifact v1.8.1 does not have provenance: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/227396308","Warn: release artifact v1.8.0 does not have provenance: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/225792889","Warn: release artifact v1.7.1 does not have provenance: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/205289332","Warn: release artifact v1.7.0 does not have provenance: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/200102086","Warn: release artifact v1.6.5 does not have provenance: https://api.github.com/repos/piraeusdatastore/linstor-csi/releases/199789100"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/build.yml:10"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 28 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-20T21:43:00.813Z","repository_id":37962159,"created_at":"2025-08-20T21:43:00.813Z","updated_at":"2025-08-20T21:43:00.813Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28479409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csi","kubernetes","linstor","persistent-storage","sds"],"created_at":"2024-08-01T15:01:59.290Z","updated_at":"2026-01-16T15:27:54.849Z","avatar_url":"https://github.com/piraeusdatastore.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Linstor CSI Plugin\n\n[![build](https://github.com/piraeusdatastore/linstor-csi/actions/workflows/build.yml/badge.svg)](https://github.com/piraeusdatastore/linstor-csi/actions/workflows/build.yml)\n[![tests](https://github.com/piraeusdatastore/linstor-csi/actions/workflows/tests.yml/badge.svg)](https://github.com/piraeusdatastore/linstor-csi/actions/workflows/tests.yml)\n![latest version](https://img.shields.io/github/v/tag/piraeusdatastore/linstor-csi?label=version\u0026sort=semver)\n\nThis CSI plugin allows for the use of LINSTOR volumes on Container Orchestrators\nthat implement CSI, such as Kubernetes.\n\n# Building\n\nIf you wish to create a docker image for a local registry run `make upload REGISTRY=local.example.com`.\n\n# Deployment\n\nIf you are looking to deploy a full LINSTOR setup with LINSTOR controller and satellites,\ntake a look at [our operator](https://github.com/piraeusdatastore/piraeus-operator).\n\nThis project _ONLY_ deploys the CSI components, a working LINSTOR cluster is required.\nUse our example deployment in `examples/k8s/deploy` as base to deploy only the LINSTOR CSI\ncomponents. You will need to update every occurence of `LINSTOR_CONTROLLER_URL` with the actual\nURL of your LINSTOR Controller, for example like this:\n\n```\n$ LINSTOR_CONTROLLER_URL=http://linstor-controller.example.com:3370\n$ kubectl kustomize http://github.com/piraeusdatastore/linstor-csi/examples/k8s/deploy \\\n  | sed \"s#LINSTOR_CONTROLLER_URL#$LINSTOR_CONTROLLER_URL#\" \\\n  | kubectl apply --server-side -f -\n```\n\n# Usage\n\nThis project must be used in conjunction with a working LINSTOR cluster, version\n0.9.11 or better.\n[LINSTOR's documentation](https://www.linbit.com/drbd-user-guide/linstor-guide-1_0-en/)\nis the foremost guide on setting up and administering LINSTOR.\n\n## Kubernetes\n\nAfter the plugin has been deployed, you're free to create storage classes\nthat point to the name of the external provisioner associateed with the CSI plugin\nand have your users start provisioning volumes from them. A basic storage class could\nlook like this:\n\n```yaml\napiVersion: storage.k8s.io/v1\nkind: StorageClass\nmetadata:\n  name: linstor-basic-storage\nprovisioner: linstor.csi.linbit.com\nallowVolumeExpansion: true\nparameters:\n  linstor.csi.linbit.com/placementCount: \"2\"\n  linstor.csi.linbit.com/storagePool: \"my-storage-pool\"\n  linstor.csi.linbit.com/resourceGroup: \"linstor-basic-storage\"\n  csi.storage.k8s.io/fstype: xfs\n  # You can override LINSTOR properties by adding the property.linstor.csi.linbit.com prefix:\n  property.linstor.csi.linbit.com/DrbdOptions/auto-quorum: suspend-io\n```\n\nA full list of all parameters usable in a storage class is available\n[here](https://www.linbit.com/drbd-user-guide/linstor-guide-1_0-en/#s-kubernetes-sc-parameters).\n\nEnsure that all kubelets that are expected to use LINSTOR volumes have a running\nLINSTOR satellite that is configured to work with the LINSTOR controller\nconfigured in the plugin's deployment files and that the storage pool indicated\nin the storage class has been properly configured. This pool does not need to be\npresent on the Kubelets themselves for volumes attached over the network.\n\nMost of the documentation for using this project with Kubernetes is located\n[here](https://docs.linbit.com/docs/users-guide-9.0/#ch-kubernetes).\n\n## Kubevirt\n\nAn example of using the CSI driver in combination with kubevirt (block device mode, live migration) can be\nfound in the `examples/kubevirt/` directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiraeusdatastore%2Flinstor-csi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiraeusdatastore%2Flinstor-csi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiraeusdatastore%2Flinstor-csi/lists"}