portainer/portainer · error

Failed to extract dir %s

Error message

Failed to extract dir %s

What it means

Error "Failed to extract dir %s" thrown in portainer/portainer.

Source

Thrown at api/archive/targz.go:114

	for {
		header, err := tarReader.Next()

		if errors.Is(err, io.EOF) {
			break
		}

		if err != nil {
			return err
		}

		switch header.Typeflag {
		case tar.TypeDir:
			// skip, dir will be created with a file
		case tar.TypeReg:
			p := filesystem.JoinPaths(outputDirPath, header.Name)
			if err := os.MkdirAll(filepath.Dir(p), 0o744); err != nil {
				return fmt.Errorf("Failed to extract dir %s", filepath.Dir(p))
			}
			outFile, err := os.Create(p)
			if err != nil {
				return fmt.Errorf("Failed to create file %s", header.Name)
			}
			if _, err := io.Copy(outFile, tarReader); err != nil {
				return fmt.Errorf("Failed to extract file %s", header.Name)
			}
			logs.CloseAndLogErr(outFile)
		default:
			return fmt.Errorf("tar: unknown type: %v in %s",
				header.Typeflag,
				header.Name)
		}
	}

	return nil
}

View on GitHub (pinned to 17e74456ff)

When it happens

Trigger: Thrown at api/archive/targz.go:114 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of portainer/portainer@17e74456ff (2026-08-26). Data as JSON: /api/errors/39925ad074a2b0fd. Report an issue: GitHub.