Docker for Mac: add page on disk space #6944
Conversation
The disk space usage of Docker on Mac has been difficult to manage and has confused lots of people, see docker/for-mac#371 This patch adds a top-level section to the Docker for Mac docs alongside networking which explains - where the space has gone - how to reclaim some of it In future I'd like to add more about why some systems use `Docker.raw` and some `Docker.qcow2` but we're in a transitional state at the moment. It'll be simpler to explain after the next stable version has been released. Signed-off-by: David Scott <dave.scott@docker.com>
|
Thanks for your work! I think this will help a lot. Do you think it would be useful to communicate this in the docker mac UI? optimal ✅ compatibility mode compatibility mode compatibility mode |
|
@gtardif - PTAL - thank you! |
| ``` | ||
| then list containers with: | ||
| ```bash | ||
| $ docker container ls -a |
There was a problem hiding this comment.
Might want to use docker system df instead of checking only containers and images; doing so also shows how much the actual use is, and how much is reclaimable https://docs.docker.com/engine/reference/commandline/system_df/
There was a problem hiding this comment.
Same comment as above. Thank you for the input!
There was a problem hiding this comment.
This also looks fine to me!
|
|
||
| Note that other tools may display the space usage of the file incorrectly. | ||
|
|
||
| ## If the file is too big |
There was a problem hiding this comment.
Should we mention the actual vs virtual size of the file?
There was a problem hiding this comment.
Yes good idea. It's mentioned further down but it would be good to bring it nearer the top since it's bound to be a frequent source of confusion.
There was a problem hiding this comment.
@thaJeztah @djs55 - Thank you both for the input! Please see my latest updates to see if this is what you are looking for and if more is needed.
There was a problem hiding this comment.
This looks fine to me!
|
@thaJeztah @djs55 - Thank you both for the input! Please see my latest updates to see if this is what you are looking for and if more is needed. |
|
Deploy preview for docsdocker ready! Built with commit 9aa8abe |
ghost
self-requested a review
|
Merging this - will open up a separate PR for TOC update. Thank you @djs55 and @thaJeztah ! |
Proposed changes
The disk space usage of Docker on Mac has been difficult to manage and has confused lots of people, see
docker/for-mac#371
This patch adds a top-level section to the Docker for Mac docs alongside networking which explains
In future I'd like to add more about why some systems use
Docker.rawand someDocker.qcow2but we're in a transitional state at the moment. It'll be simpler to explain after the next stable version has been released.Related issues (optional)
Related to docker/for-mac#371