The disk space usage of Docker on Mac has been difficult to manage
and has confused lots of people, see
https://github.com/docker/for-mac/issues/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>
This will soon be obsoleted by com.docker.diagnose, but meanwhile it
is still important information.
Signed-off-by: Akim Demaille <akim.demaille@docker.com>
There's no need to document this in both Troubleshoot and FAQ. Keep
it in the FAQ. We don't need to reinstall Docker for Mac, and it's
possible to save all the data.
Signed-off-by: Akim Demaille <akim.demaille@docker.com>
consolidating some useful information. The following lines have to be added to the ~/.bash_profile for it to work. I pulled this information from https://docs.docker.com/compose/completion/.
I thought it would be useful to add it here so that all this info could be in one place.
if [ -f $(brew --prefix)/etc/bash_completion ]; then
. $(brew --prefix)/etc/bash_completion
fi
* Mac: teach how to migrate from toolbox by hand
We have removed the Toolbox migration tools from Docker for Mac (and
soon for Windows too) because they add a lot of pressure on the code
for a feature which is almost never used today by our users.
Signed-off-by: Akim Demaille <akim.demaille@docker.com>
* Reword lots of instances of 'will'
* Reword lots of instances of won't
* Reword lots of instances of we'll
* Eradicate you'll
* Eradicate 'be able to' type of phrases
* Eradicate 'unable to' type of phrases
* Eradicate 'has / have to' type of phrases
* Eradicate 'note that' type of phrases
* Eradicate 'in order to' type of phrases
* Redirect to official Chef and Puppet docs
* Eradicate gratuitous 'please'
* Reduce use of e.g.
* Reduce use of i.e.
* Reduce use of N.B.
* Get rid of 'sexagesimal' and correct some errors
* Mac: fix name of the vm directory
Actually the directory name changed from vm to vms/0 (there has been
no release with vm, we may remove references to it). This is for the
forthcoming 18.01 Edge release, but since it's already published we
should probably update now.
Signed-off-by: Akim Demaille <akim.demaille@docker.com>
* Toolbox: formatting changes
No user visible changes here, just making future diffs easier to read.
Signed-off-by: Akim Demaille <akim.demaille@docker.com>
* Toolbox: do not invite to remove ~/.docker
Docker for Mac uses that directory too.
Signed-off-by: Akim Demaille <akim.demaille@docker.com>
* Mac: the disk image has moved
In the forthcoming release of Docker for Mac, the disk image is in
another directory (was needed for future changes).
Signed-off-by: Akim Demaille <akim.demaille@docker.com>
* Mac: FAQ: Promote "Disk Usage" questions
One level upper.
Signed-off-by: Akim Demaille <akim.demaille@docker.com>
This commit reorders this
### Stable and Edge channels
### What is Docker.app?
### What kind of feedback are we looking for?
### What if I have problems or questions?
### How can I opt out of sending my usage data?
### Can I use Docker for Mac with new swarm mode?
### How do I connect to the remote Docker Engine API?
### How do I connect from a container to a service on the host?
### How do I connect to a container from the Mac?
### How do I add custom CA certificates?
### How do I add client certificates?
### How do I reduce the size of Docker.qcow2?
### What are system requirements for Docker for Mac?
### Do I need to reinstall Docker for Mac if I change the name of my macOS account?
### Do I need to uninstall Docker Toolbox to use Docker for Mac?
### How do I uninstall Docker Toolbox?
### What is HyperKit?
### What is the benefit of HyperKit?
### Why is com.docker.vmnetd running after I quit the app?
### Can I pass through a USB device to a container?
into this
## Questions about Docker.app
### Stable and Edge channels
### What is Docker.app?
### What are system requirements for Docker for Mac?
### Do I need to reinstall Docker for Mac if I change the name of my macOS account?
### Do I need to uninstall Docker Toolbox to use Docker for Mac?
### How do I uninstall Docker Toolbox?
## Questions about feedback and help
### What kind of feedback are we looking for?
### What if I have problems or questions?
### How can I opt out of sending my usage data?
## How can I...?
### Can I use Docker for Mac with swarm mode?
### How do I connect to the remote Docker Engine API?
### How do I connect from a container to a service on the host?
### How do I connect to a container from the Mac?
### How do I add custom CA certificates?
### How do I add client certificates?
### How do I reduce the size of Docker.qcow2?
### Can I pass through a USB device to a container?
## Components of Docker for Mac
### What is HyperKit?
### What is the benefit of HyperKit?
### Why is com.docker.vmnetd running after I quit the app?
Also, change "new swarm mode" into "swarm mode".
Signed-off-by: Akim Demaille <akim.demaille@gmail.com>
* Mac: FAQ: Disk usage in raw format
This is a new feature of Docker for Mac. Questions and PRs have
already been made about this, and we expect more of them.
Signed-off-by: Akim Demaille <akim.demaille@gmail.com>
* for all links to , changed to full path
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed link in Swarm Tutorial per review comments
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added Compose topics on caching options for performance
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* updated title for Compose topic
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* line wrap per review
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* add CSS tests for Josh
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* new class inline for images, updated docs to call class
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* removing last test paragraph
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* Docker for Mac, Windows 17.06 stable, edge
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* incorporated review comments
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* changed Docker Cloud site links to open in new window
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
Rather than manually creating a custom IP alas on the host, a container
can connect to the host by resolving the DNS name `docker.for.mac.localhost`.
Signed-off-by: David Scott <dave.scott@docker.com>
* add d4mac client side FAQ
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added link to FAQs from Getting Started
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added FAQs re: installing client certificates
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added more detail on client and server side certs
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed Mac and Windows specific topics
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed formatting so that content renders properly
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* incorporated review comments
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* updated Windows FAQ to clarify directories copy, remove refs to db
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* change ref from Mac to Windows on Win side
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added certificate topic to Win getting started
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* review comments, remove 'entities' clarify meaning
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* d4mac,win 17.06 edge release notes, docs updates
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added description of new feature shared drives on demand for Windows Edge
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added missing stable release notes for mac and win
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* copyedit, kick build
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* Update the osxfs documentation with recent details about caching.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* Add a note about 'cached' to the volumes tutorial.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* Add a document giving a detailed specification of osxfs caching.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* Americanize spelling in the osxfs-caching document.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* More osxfs benchmark details for 'go list'.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* Remove mentions of the blog post.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* editorial, topic structure changes, x-refs
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* linked to new topic also where bind mounts are discussed in Namespaces
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* added more tags
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* Decapitalize descriptions
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* "releease" ~> "release"
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* Use @avsm's suggested rewording for the osxfs-caching introduction.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* Add an example showing how to use `cached`, `consistent`, etc.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* Add a link to the user-guided caching blog post.
Signed-off-by: Jeremy Yallop <yallop@docker.com>
* added examples heading, more x-refs to blog post, docker run
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* escaped second dash in --volume long version of command
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed double dashes on volume option to render properly
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* fixed notes on d4mac, d4win per new format
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* streamlined d4win pre-install notes, surfaced toolbox option
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
* Update fedora.md
add warning class to blogquote
* Update linux-postinstall.md
add warning class to blogquote
* Update ubuntu.md
add warning class to blogquote
* Update https.md
add warning class to blogquote
* Update swarm_manager_locking.md
add warning class to blogquote
* Update dockerlinks.md
add warning class to blogquote
* Update deploying.md
add warning class to blogquote
* Update deploying.md
add warning class to blogquote
* Update insecure.md
add warning class to blogquote
* Update discovery.md
add warning class to blogquote
* Update dockerd.yaml
add warning class to blogquote
* Update docker_secret_rm.yaml
add warning class to blogquote
* Update docker_service_rm.yaml
add warning class to blogquote
* Update docker_secret_rm.yaml
add warning class to blogquote
* Update scale-your-cluster.md
add warning class to blogquote
* Update resource_constraints.md
add warning class to blogquote
* Update binaries.md
add warning class to blogquote
* Update content_trust.md
add warning class to blogquote
* Update secrets.md
add warning class to blogquote
* Update index.md
add warning class to blogquote
* Update install-sandbox-2.md
add warning class to blogquote
* Update docker-toolbox.md
add warning class to blogquote
* Update index.md
add warning class to blogquote
* Update centos.md
add warning class to blogquote
* Update debian.md
add warning class to blogquote
* Update faqs.md
add linebreak after Looking for popular FAQs on Docker for Windows?
* Update install.md
add linebreake after **Already have Docker for Windows?**
* Revert "Update dockerd.yaml"
This reverts commit 3a98eb86f700ade8941483546c33f69a9dab8ac3.
* Revert "Update docker_secret_rm.yaml"
This reverts commit 5dc1e75f37033932486c11287052b7d64bf83e55.
* Revert "Update docker_service_rm.yaml"
This reverts commit a983380a5625b471f1a03f8ed2301ead72f98f1b.
* Revert "Update docker_secret_rm.yaml"
This reverts commit 4c454b883c300e26fbb056b954bb49ec2933b172.
* Fix manager and worker join tokens. Issue #2088.
Fix screenshots per issue #2126
Move vote images to correct dir
Fix rendering issue with inline code snippet #1990
Fix for stack yaml reference (#1476)
Fix image link
Add shutdown procedures for #1017
* Make the fix asked in the PR
Little fix
Guillaume Tardif
David Scott
Justin
Akim Demaille
Gwendolynne Barr
gtardif
Akim Demaille
Alan Buxey
Joao Fernandes
Jingwen Peng
Joao Fernandes
Jose E
Jim Galasyn
James Sharpe
Alec Clews
Sasha Gerrand
Misty Stanley-Jones
Ingve Vormestrand
Takuto Kanzaki
Sebastiaan van Stijn
Ameya Shenoy
Alejandro Avilés
Victoria Bialas
pinata-mac
Jonathan Sokolowski
Wang Jie
nmur
Steven Bedrick
Hawley Waldman
skymon
Joseph Rex
Dave Scott
Nathan Handler
Joe
yallop
Lenny Linux
Julien Maitrehenry
Steven Hanna