Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Document how to enable support for zstd-compressed base layers

Open Beginner friendly
#4,538 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
74/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
java
Domain
documentation

Research direction

Start by reading the documentation and FAQ sections for configuring base images in the Gradle and Maven plugins, then trace how the zstd support added in #3717 is enabled. Update the docs with steps to enable support and clarify any required dependency. Done when both plugin users can follow the documented steps to use a zstd-compressed base image.

Written by the indexing model from the issue text.

Description

Environment:

  • Jib version: 3.5.4
  • Build tool: Gradle 9.8.2
  • OS: macOS 27.2

Description of the issue:

#3717 added support for zstd-compressed base layers. But the usage for Gradle (and perhaps Maven) plugin users is not clear to me

Expected behavior:

The documentation and FAQs are updated with steps to enable the support.

Steps to reproduce:

Any Java project with a base image that is using zstd compression, e.g. DHI Temurin.

jib-gradle-plugin Configuration:

plugins {
    id 'java'
    id 'com.google.cloud.tools.jib' version '3.5.4'
}

jib {
    from {
        image = 'dhi.io/eclipse-temurin:21.0.13.9-debian13@sha256:31452f600f695aa68471e46538098b6022b63f932c36e9bec66e37a3dfbc6f47'
    }
}

Log output:

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':backend:jibBuildTar' (registered by plugin 'com.google.cloud.tools.jib').
> com.google.cloud.tools.jib.plugins.common.BuildStepsExecutionException: org.apache.commons.compress.compressors.CompressorException: Could not create CompressorInputStream.

Zstandard compression is not available. In addition to Apache Commons Compress you need the Zstd JNI library - see https://github.com/luben/zstd-jni

Additional Information:

Dominant language
Java
Stars
14.5k
Forks
1.5k
Avg merge
40m
Merged PRs (30d)
1

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from GoogleContainerTools/jib

All issues in GoogleContainerTools/jib

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.