ollama - ✅(Solved) Fix Manual install documentation - extracting tar.zst fails [1 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
ollama/ollama#15693Fetched 2026-04-19 15:04:08
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
cross-referenced ×1labeled ×1referenced ×1

Error Message

I get the following error: tar: Error is not recoverable: exiting now

Fix Action

Fixed

PR fix notes

PR #15694: docs(linux): add --zstd flag to tar commands for .tar.zst archives

Description (problem / solution / changelog)

The manual install instructions pipe .tar.zst archives into tar x, but GNU tar requires the --zstd option to decompress zstd-compressed archives. Without it, users get:

tar: Archive is compressed. Use --zstd option
tar: Error is not recoverable: exiting now

Added --zstd to all four tar invocations in docs/linux.mdx (amd64, amd64-rocm, arm64, and the update section).

Fixes #15693

Changed files

  • docs/linux.mdx (modified, +4/-4)

Code Example

curl -fsSL https://ollama.com/download/ollama-linux-amd64.tar.zst \
    | sudo tar x -C /usr

---

curl -fsSL https://ollama.com/download/ollama-linux-amd64.tar.zst \
    | sudo tar x -C /usr
tar: Archive is compressed. Use --zstd option
tar: Error is not recoverable: exiting now
curl: (23) Failure writing output to destination
RAW_BUFFERClick to expand / collapse

What is the issue?

In the manual install steps: https://docs.ollama.com/linux, one of the steps to download Ollama archive and extract the binaries fails.

curl -fsSL https://ollama.com/download/ollama-linux-amd64.tar.zst \
    | sudo tar x -C /usr

If I modify the options used for tar I can get it to unzip properly.

Relevant log output

I get the following error:

curl -fsSL https://ollama.com/download/ollama-linux-amd64.tar.zst \
    | sudo tar x -C /usr
tar: Archive is compressed. Use --zstd option
tar: Error is not recoverable: exiting now
curl: (23) Failure writing output to destination

OS

Linux

GPU

AMD

CPU

AMD

Ollama version

n/a

extent analysis

TL;DR

The issue can likely be resolved by adding the --zstd option to the tar command to properly decompress the archive.

Guidance

  • The error message tar: Archive is compressed. Use --zstd option suggests that the archive is compressed using zstd, which is not being handled by the default tar options.
  • To fix the issue, modify the tar command to include the --zstd option, like this: tar --zstd -x -C /usr.
  • Verify that the archive is properly extracted by checking the contents of the /usr directory after running the modified command.
  • If the issue persists, ensure that the zstd utility is installed and available on the system.

Example

curl -fsSL https://ollama.com/download/ollama-linux-amd64.tar.zst \
    | sudo tar --zstd -x -C /usr

Notes

The solution assumes that the zstd utility is installed and available on the system. If not, it may need to be installed separately.

Recommendation

Apply workaround: add the --zstd option to the tar command, as it directly addresses the error message and is a straightforward fix.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

ollama - ✅(Solved) Fix Manual install documentation - extracting tar.zst fails [1 pull requests, 1 participants]