ipfs/kubo · error

%s not found in zip

Error message

%s not found in zip

What it means

Fired by the kubo self-update flow in extractFromZip when the downloaded zip archive contains no file matching the expected binary name. Same cause as the tar.gz variant: the release asset does not contain the expected platform binary, so extraction cannot proceed.

Source

Thrown at core/commands/update.go:820

	for _, f := range zr.File {
		if f.Name != lookFor {
			continue
		}
		rc, err := f.Open()
		if err != nil {
			return nil, err
		}
		result, err := io.ReadAll(io.LimitReader(rc, maxBinarySize+1))
		rc.Close()
		if err != nil {
			return nil, err
		}
		if int64(len(result)) > maxBinarySize {
			return nil, fmt.Errorf("extracted binary exceeds maximum size of %d bytes", maxBinarySize)
		}
		return result, nil
	}
	return nil, fmt.Errorf("%s not found in zip", lookFor)
}

// trimVPrefix removes a leading "v" from a version string.
func trimVPrefix(s string) string {
	return strings.TrimPrefix(s, "v")
}

// normalizeVersion ensures a version string has a "v" prefix (for GitHub tags).
func normalizeVersion(s string) string {
	s = strings.TrimSpace(s)
	if !strings.HasPrefix(s, "v") {
		return "v" + s
	}
	return s
}

// isNewerVersion returns true if target is newer than current.
func isNewerVersion(current, target string) (bool, error) {

View on GitHub (pinned to 329838acdf)

Solutions

1. Retry later; CI may still be uploading build artifacts
2. Verify the release has a binary for this OS/arch
3. Install manually from dist.ipfs.tech

When it happens

Trigger: Thrown at core/commands/update.go:820 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ipfs/kubo@329838acdf (2026-09-03). Data as JSON: /api/errors/356df1ec49083968. Report an issue: GitHub.