# github-actions-cache-server

> Self-hosted open-source reimplementation of GitHub's Actions cache service; works with the stock actions/cache step, storing data on S3, GCS, Azure or the filesystem.

- **Category:** CI/CD
- **Licence:** MIT
- **Latest version:** v10.0.0
- **Open source:** oss
- **Languages:** Typescript, Rust
- **Platforms:** Docker Compose, Helm
- **Tags:** SQLite, MySQL, Docker, Rust, Helm, S3, Ci, Github Actions, Gcs, Prometheus, Minio, Caching, Self Hosted, Azure blob storage, Self hosted runner, Postgres, Ci Cd, Github Actions Cache, Build Cache, Actions Cache, Cache Server

## Description

The GitHub Actions Cache Server is a reimplementation of GitHub's hosted Actions cache service that runs on your own infrastructure. Because it speaks the same cache API, the official actions/cache action and packages that use it internally keep working with no workflow edits — only the self-hosted runner needs its ACTIONS_RESULTS_URL pointed at the cache server, either via a patched runner binary or the project's forked runner image. Cache payloads can live on the local filesystem, S3-compatible buckets, Google Cloud Storage or Azure Blob Storage, while metadata is kept in PostgreSQL, MySQL or SQLite. Notable capabilities include signed direct-download URLs that bypass the server, eager merging of cache parts inside the bucket, automatic cleanup of stale entries, LRU eviction against a size budget, a Prometheus metrics endpoint, an optional management API, and transparent forwarding of non-cache requests to GitHub's Results service. It is deployed as a single container (Docker Compose) or through a Helm chart. GitHub Enterprise Server also works, though the project treats that as best-effort and implements only the v2 cache protocol, so legacy v1 caching will not function. The project is MIT-licensed and under active development.

## Links

- [Homepage](https://github.com/falcondev-oss/github-actions-cache-server)
- [Website](https://gha-cache-server.falcondev.io)
- [Docker](ghcr.io/falcondev-oss/github-actions-cache-server)
- [How it works](https://gha-cache-server.falcondev.io/how-it-works)
- [Getting Started documentation](https://gha-cache-server.falcondev.io/getting-started)

---
Source: https://selfhost.directory/project/github-actions-cache-server