Skip to content

Fix issue #24010: warn about containerd separate storage path#24447

Open
dvdksn wants to merge 3 commits intomainfrom
fix/issue-24010-containerd-storage
Open

Fix issue #24010: warn about containerd separate storage path#24447
dvdksn wants to merge 3 commits intomainfrom
fix/issue-24010-containerd-storage

Conversation

@dvdksn
Copy link
Contributor

@dvdksn dvdksn commented Mar 20, 2026

Adds warning about containerd using a separate storage path from the Docker data directory.

Changes:

  • Added IMPORTANT callout in "Disk space usage" section explaining that containerd uses separate storage
  • Warns users with custom data directories that they need to configure containerd separately
  • Links to containerd configuration documentation for data directory setup

This prevents users from unexpectedly filling their root partition when they assumed their custom data directory configuration would apply to containerd.

Fixes #24010

@netlify
Copy link

netlify bot commented Mar 20, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 0964a53
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69bd3c748e8a6000086de0e3
😎 Deploy Preview https://deploy-preview-24447--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added area/engine Issue affects Docker engine/daemon area/storage Relates to storage, volumes dependencies Vendoring, packaging updates labels Mar 20, 2026
Copy link
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

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

Assessment: 🟡 NEEDS ATTENTION

This PR adds a valuable warning about containerd using a separate storage path from the Docker data directory. The content addresses a real user issue (filling root partitions when custom data directories are configured).

Issues found:

  • 1 style guide violation (bold used for emphasis)
  • 1 maintainability concern (external link stability)

- Remove bold formatting from 'not' (bold should only be used for UI elements)

- Update containerd docs link from main branch to stable v2.2.2 release

Assisted-By: docker-agent
@dvdksn
Copy link
Contributor Author

dvdksn commented Mar 20, 2026

Thank you for the feedback on both the style violation and link stability concern. You're right on both counts.

I've made the following changes:

  • Removed the bold emphasis (our style guide reserves bold for UI elements only, not for emphasis)
  • Updated the link to point to the stable v2.0.0 release instead of the latest tag, which should provide better long-term stability

The warning now follows our documentation standards while maintaining a reliable reference.

@dvdksn dvdksn requested a review from a team March 20, 2026 11:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent/generated area/engine Issue affects Docker engine/daemon area/storage Relates to storage, volumes dependencies Vendoring, packaging updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Migration steps to containerd should include details for those not using the default docker data path

1 participant