Skip to main content
Storage plugin · listing tai42/storage-github

​
Install

​
Permissions

​
Provides

​
github

Storage — Storage backend serving text and binary/media content over a GitHub repository. Stores content as files on a branch of a GitHub repository, which makes every write a commit and every version reviewable. Select it in the manifest:
manifest.yml

​
Configuration

​
Token scopes

A fine-grained token needs Contents: read and write on the repository; a classic token needs repo. Only STORAGE_GITHUB_TOKEN is read — an ambient GITHUB_TOKEN is ignored, as are proxy environment variables.

​
Quirks

Two limits shape what this provider suits. Writes are capped at 1 MiB and a larger payload raises before the request. Reads are GitHub REST API calls, and GitHub allows 60 of them an hour without a token and 5000 with one.
A whole read and a stat are one REST call each, made at the configured branch, so they answer the branch as it is right after a write. A ranged read resolves the branch’s head commit (one REST call) and then reads the raw content host at that commit with a Range header; reading at the commit, never at the branch name, means it never serves a cached copy of an older version. Listing uses the recursive tree API and raises on a truncated response rather than acting on a partial listing. The API host is fixed, so GitHub Enterprise Server is not supported.

​
See also