ryanccn/attic-action

Cache Nix derivations on GitHub Actions with Attic

TypeScript

59

56 commits

updated Sep 22, 2026

See the code

README

attic-action

Cache Nix derivations with Attic.

Usage

Configure your Attic instance with an endpoint, a cache, and a token that can read from and write to the cache. Then, add this step to a workflow job after Nix is installed:

- name: Setup Attic cache
  uses: ryanccn/attic-action@v0
  with:
    endpoint: ${{ secrets.ATTIC_ENDPOINT }}
    cache: ${{ secrets.ATTIC_CACHE }}
    token: ${{ secrets.ATTIC_TOKEN }}

Inputs

endpoint

The Attic endpoint. This is the URL without the cache name.

cache

The name of the Attic cache.

token

The authorization token to provide to Attic (optional).

inputs-from

Path to get the Nixpkgs flake input from instead of github:NixOS/nixpkgs/nixpkgs-unstable when installing Attic (optional).

push-args

Additional command-line arguments to pass to attic push (optional).

skip-push

Disable pushing new derivations to the cache automatically at the end of the job (default is false).

This requires you to invoke attic push <cache> with the paths you want to push to the cache manually.

Outputs

None

License

MIT

attic
cache
ci
ci-cd
github-actions
github-actions-cache
nix
nix-flake

Contributors

ryanccn

33 commits

dependabot[bot]

12 commits

getchoo

5 commits

nifoc

1 commits

ryanccn/attic-action

Cache Nix derivations on GitHub Actions with Attic

TypeScript

59

56 commits

updated Sep 22, 2026

See the code

README

attic-action

Cache Nix derivations with Attic.

Usage

Configure your Attic instance with an endpoint, a cache, and a token that can read from and write to the cache. Then, add this step to a workflow job after Nix is installed:

- name: Setup Attic cache
  uses: ryanccn/attic-action@v0
  with:
    endpoint: ${{ secrets.ATTIC_ENDPOINT }}
    cache: ${{ secrets.ATTIC_CACHE }}
    token: ${{ secrets.ATTIC_TOKEN }}

Inputs

endpoint

The Attic endpoint. This is the URL without the cache name.

cache

The name of the Attic cache.

token

The authorization token to provide to Attic (optional).

inputs-from

Path to get the Nixpkgs flake input from instead of github:NixOS/nixpkgs/nixpkgs-unstable when installing Attic (optional).

push-args

Additional command-line arguments to pass to attic push (optional).

skip-push

Disable pushing new derivations to the cache automatically at the end of the job (default is false).

This requires you to invoke attic push <cache> with the paths you want to push to the cache manually.

Outputs

None

License

MIT

attic
cache
ci
ci-cd
github-actions
github-actions-cache
nix
nix-flake

Contributors

ryanccn

33 commits

dependabot[bot]

12 commits

getchoo

5 commits

nifoc

1 commits

Languages

TypeScript

87.7%

Nix

12.3%