Skip to content
Docs
Errors

tar_header_not_canonical

A tar header or its padding differs from the canonical ustar encoding.

A tar header or its padding differs from the canonical ustar encoding.

KindBuild or validation problem
Reported byArchive validation (registry, room hosts, disko publish)
disko exit code1 (problems)

A tar header, or the padding after a file, differs from the one fixed encoding disko accepts. Every field is set exactly (mode 0644, owner 0, modification time 0, regular files only, plain ustar with no pax or GNU extensions), so the same files always produce the same bytes and the same digest.

Why it happens

Archive validation reports this code: the registry on upload, and room hosts before loading. disko publish writes canonical headers. General-purpose tar tools record real permissions, owners and timestamps, add directory entries or extension headers, and so fail this check.

Wrong

sh
sh

See also