Skip to content

[DOCS] crun compatibility fix for OCI runtime spec v1.2.1 (Resolved in crun v1.14.3) #27272

@nimdrak

Description

@nimdrak

Problem Description

When using modern versions of Podman (v5.x+) on distributions with specific crun package versions, users encounter a version compatibility error from the OCI runtime.

Podman generates the OCI Runtime Configuration (config.json) using the latest OCI Runtime Specification (e.g., v1.2.1). However, certain older crun packages fail to correctly validate this version string and incorrectly reject the configuration.

Environment Details (Failure Case):

  • Podman Version: 5.6.2
  • Crun Version: 1.14.1 (from apt)
  • OS: Ubuntu 24.04

Observed Error:

Error: OCI runtime error: crun: unknown version specified

Observed Resolution / Fixed Version

I have confirmed that this compatibility issue is resolved starting from crun version 1.14.3.

Upgrading to this version ensures that crun correctly parses and executes container bundles generated with OCI Runtime Specification v1.2.1.

(Reference: crun v1.14.3 Release on GitHub)

Proposed Documentation Change

I suggest updating the minimum required version for crun in the Podman documentation to prevent this recurring issue at https://github.com/containers/podman.io/blob/main/docs/installation.md#crun--runc

... The minimum required version is v1.1.11 for runc and v1.14.3 for crun.

The OCI version (e.g. v1.2.1) is set by the fixed constant in the runtime-spec Go library. However, making users aware of the v1.14.3 minimum requirement would be helpful to prevent recurring crun: unknown version specified errors and ensure a smooth user experience.

Feel free to give opinions. 🙇

Metadata

Metadata

Assignees

No one assigned

    Labels

    Good First IssueThis issue would be a good issue for a first time contributor to undertake.documentationIssue or fix is in project documentationlocked - please file new issue/PRAssist humans wanting to comment on an old issue or PR with locked comments.triagedIssue has been triaged

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions