Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
0ac040e
docs(http): say the shared extraction store is trusted as is
jdx Oct 9, 2026
b49bac0
docs(lock): explain why mise can't validate restored caches
jdx Oct 9, 2026
a5b5a54
docs(lock): note that entries without a checksum are generated, not v…
jdx Oct 9, 2026
6eb9b9d
docs(http): say how to discard an untrusted shared extraction store
jdx Oct 9, 2026
2311d94
docs(lock): shorten the restored cache warning
jdx Oct 9, 2026
6332926
feat(http): reuse verified downloads from a checksum-keyed cache
jdx Oct 9, 2026
76e7964
fix(http): give each download cache store its own temp file
jdx Oct 9, 2026
81e623e
feat: reuse downloads the server confirms are unchanged
jdx Oct 9, 2026
e04dbcf
fix(http): copy into the download cache through a closed temp path
jdx Oct 9, 2026
00a77aa
fix(http): restore cached downloads atomically and state what the cac…
jdx Oct 9, 2026
8c5702b
fix(settings): sort download_cache alphabetically
jdx Oct 9, 2026
5d7ee3e
wip: merge the download caches into one content-addressed store
jdx Oct 9, 2026
bd636f6
feat: install from the download store without copying, and deprecate …
jdx Oct 9, 2026
f0b2485
fix(http): keep the download just stored out of eviction and correct …
jdx Oct 9, 2026
b4df2be
fix(http): replace a damaged stored download, place over an existing …
jdx Oct 9, 2026
b59c20b
test(plugins): turn the download cache off where a corrupt download i…
jdx Oct 9, 2026
86d1683
fix(http): name the path-length failure when placing a download, keep…
jdx Oct 9, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/continuous-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,11 @@ jobs:
- run: mise run test
```

::: warning
A restored tool cache is trusted as is: mise does not check installed files against
`mise.lock`. See [Restored caches and installed tools](/dev-tools/mise-lock.html#restored-caches).
:::

The example assumes a `test` task in `mise.toml`, such as
`test = "npm ci && npm test"` under `[tasks]`. `mise exec -- npm test` works as
well.
Expand Down
6 changes: 6 additions & 0 deletions docs/dev-tools/backends/http.md
Original file line number Diff line number Diff line change
Expand Up @@ -552,6 +552,12 @@ Changes to shared files, including changes made by a `postinstall` hook, affect
every install that uses them. `mise install --system`, `mise install --shared`
and `mise install-into` destinations always get their own copy.

::: warning The shared store is trusted as is
mise does not re-check files already in `http-tarballs` against the lockfile
checksum. Don't let untrusted jobs or users write to a shared or restored store.
See [Restored caches and installed tools](/dev-tools/mise-lock.html#restored-caches).
:::

`mise prune`, `mise cache prune` and `mise cache clear` leave `http-tarballs`
alone, because installs may still link to it. Installs made by older mise
versions may also link into it. To give an install its own copy, remove
Expand Down
21 changes: 21 additions & 0 deletions docs/dev-tools/mise-lock.md
Original file line number Diff line number Diff line change
Expand Up @@ -411,6 +411,27 @@ Lifecycle scripts can still produce different output on each machine. See
for the layout and for editing sidecars, and the [npm](/dev-tools/backends/npm.html)
and [PyPI](/dev-tools/backends/pypi.html) backend pages for installer limits.

## Restored caches and installed tools {#restored-caches}

::: warning
`mise.lock` verifies what mise downloads, not what is already on disk. A
restored CI cache or a shared extraction store is trusted as is.
:::

mise can't validate an installed tree against the lockfile. The checksum covers
the downloaded artifact, and installs are mutable on purpose: tools update
themselves and `postinstall` hooks change files. For tools built from source,
such as Python and Ruby, it covers only the source tarball, not the compiled
output.

So treat a cache as trusted build input:

- Don't restore caches written by untrusted refs or triggers.
- Save a manifest with the cache and check it on restore. That proves the cache
is unchanged since CI saved it, not that it matches the lockfile.
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved
- For a fully verified install, run `mise install --locked` with an empty data
directory.

## Provenance and verification {#provenance-and-security}

For supported backends, `mise lock` records provenance such as SLSA, Cosign,
Expand Down
Loading