Skip to content

Conversation

@tfaller
Copy link
Contributor

@tfaller tfaller commented Jan 18, 2026

If you currently try to open the repo in a DevContainer or a Github Codespace the creation of the container fails:

(!) The 'moby' option is not supported on Debian 'trixie' because 'moby-cli' and related system packages have been removed from that distribution.
(!) To continue, either set the feature option '"moby": false' or use a different base image (for example: 'debian:bookworm' or 'ubuntu-24.04').

This PR fixes this by disabling moby and using docker instead. Other potential fixes seemed not be fine to me:

  • Using debian:bookworm: trixie is stable since August 2025. We should use the most recent stable Debian
  • Using ubuntu-24.04: Would still be the recent release, however, not for long anymore. But the actual issue is, that the DevContainer feature ghcr.io/snebjorn/devcontainer-feature/chromium:latest does only seem to work on Debian. The creation with Ubuntu failed.

After disabling moby, the DevContainer worked for me as expected. Also docker-in-docker just worked. The script run-in-docker.sh can be run successfully. I’m not aware of what else relies on the docker-in-docker feature, as the commit (1ce95ff/#17095) that introduced it does not explain why it was added in the first place. It’s possible that something is broken due to the switch from moby to docker, but at least the container is functioning again instead of failing to start altogether.

PR checklist

  • Read the contribution guidelines.
  • Pull Request title clearly describes the work in the pull request and Pull Request description provides details about how to validate the work. Missing information here may result in delayed response from the community.
  • Run the following to build the project and update samples:
    ./mvnw clean package || exit
    ./bin/generate-samples.sh ./bin/configs/*.yaml || exit
    ./bin/utils/export_docs_generators.sh || exit
    
    (For Windows users, please run the script in WSL)
    Commit all changed files.
    This is important, as CI jobs will verify all generator outputs of your HEAD commit as it would merge with master.
    These must match the expectations made by your contribution.
    You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example ./bin/generate-samples.sh bin/configs/java*.
    IMPORTANT: Do NOT purge/delete any folders/files (e.g. tests) when regenerating the samples as manually written tests may be removed.

Summary by cubic

Fix DevContainer and Codespaces startup on Debian trixie by switching the docker-in-docker feature from Moby to Docker.

  • Bug Fixes
    • Set "moby": false in .devcontainer/devcontainer.json so the container builds and docker-in-docker works (run-in-docker.sh succeeds).

Written for commit db9932f. Summary will update on new commits.

Copy link

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

@wing328 wing328 added this to the 7.19.0 milestone Jan 19, 2026
@wing328 wing328 merged commit 28904f8 into OpenAPITools:master Jan 19, 2026
15 checks passed
@wing328
Copy link
Member

wing328 commented Jan 19, 2026

thanks for the PR which has been merged

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants