falcondev-oss/github-actions-cache-server

Self-hosted GitHub Actions cache server implementation. Compatible with official 'actions/cache' action

TypeScript

452

287 commits

updated Sep 14, 2026

See the code

README

πŸš€ GitHub Actions Cache Server

This is a drop-in replacement for the official GitHub hosted cache server. It is compatible with the official actions/cache action, so there is no need to change your workflow files and it even works with packages that internally use actions/cache.

Features

  • πŸ”₯ Compatible with official actions/cache action
  • πŸ“¦ Supports multiple storage solutions and is easily extendable.
  • πŸ”’ Secure and self-hosted, giving you full control over your cache data.
  • 😎 Easy setup
services:
  cache-server:
    image: ghcr.io/falcondev-oss/github-actions-cache-server
    ports:
      - '3000:3000'
    environment:
      API_BASE_URL: http://localhost:3000
      STORAGE_DRIVER: filesystem
      STORAGE_FILESYSTEM_PATH: /data/cache
      DB_DRIVER: sqlite
      DB_SQLITE_PATH: /data/cache-server.db
    volumes:
      - cache-data:/data

volumes:
  cache-data:

Documentation

πŸ‘‰ https://gha-cache-server.falcondev.io/getting-started πŸ‘ˆ

docker
github-actions
github-actions-cache
self-hosted

Contributors

LouisHaftmann

192 commits

DrJume

14 commits

dawidmalina

3 commits

falcondev-oss/github-actions-cache-server

Self-hosted GitHub Actions cache server implementation. Compatible with official 'actions/cache' action

TypeScript

452

287 commits

updated Sep 14, 2026

See the code

README

πŸš€ GitHub Actions Cache Server

This is a drop-in replacement for the official GitHub hosted cache server. It is compatible with the official actions/cache action, so there is no need to change your workflow files and it even works with packages that internally use actions/cache.

Features

  • πŸ”₯ Compatible with official actions/cache action
  • πŸ“¦ Supports multiple storage solutions and is easily extendable.
  • πŸ”’ Secure and self-hosted, giving you full control over your cache data.
  • 😎 Easy setup
services:
  cache-server:
    image: ghcr.io/falcondev-oss/github-actions-cache-server
    ports:
      - '3000:3000'
    environment:
      API_BASE_URL: http://localhost:3000
      STORAGE_DRIVER: filesystem
      STORAGE_FILESYSTEM_PATH: /data/cache
      DB_DRIVER: sqlite
      DB_SQLITE_PATH: /data/cache-server.db
    volumes:
      - cache-data:/data

volumes:
  cache-data:

Documentation

πŸ‘‰ https://gha-cache-server.falcondev.io/getting-started πŸ‘ˆ

docker
github-actions
github-actions-cache
self-hosted

Contributors

LouisHaftmann

192 commits

DrJume

14 commits

dawidmalina

3 commits

Languages

TypeScript

93.4%

Go Template

4.1%

JavaScript

2.1%