clarify Compose install prerequisites#4130
clarify Compose install prerequisites#4130londoncalling merged 7 commits intodocker:masterfrom londoncalling:compose-install-clarify
Conversation
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
compose/install.md
Outdated
| ## Prerequisites | ||
|
|
||
| 1. Install Docker Engine: | ||
| You need to install Docker first, before you install and run Docker Compose. |
There was a problem hiding this comment.
Technically that is not true - you can install Compose without having Docker installed first. You'll need access to a Docker engine to do anything useful with Compose, but that engine could be installed on a remote server.
There was a problem hiding this comment.
okay thanks I'll try to clarify this
compose/install.md
Outdated
|
|
||
| * [Windows installation](/docker-for-windows/index.md){: target="_blank" class="_"} | ||
| - On Linux systems, first install the | ||
| [Docker server](/engine/installation/index.md#server){: target="_blank" class="_"} |
There was a problem hiding this comment.
I think "the Docker server" should just be "Docker" here (or maybe "the Docker engine", but I think we're deprecating that term now?)
There was a problem hiding this comment.
@shin- I think we are gently trying to deprecate it so I changed it to just "Docker"
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
mdlinville
left a comment
mdlinville
left a comment
There was a problem hiding this comment.
One question and one nit, otherwise looking good!
compose/install.md
Outdated
|
|
||
| * [Mac installation](/docker-for-mac/index.md){: target="_blank" class="_"} | ||
| - On desktop systems like Docker for Mac and Windows, Docker Compose is | ||
| included as part of those desktop installs. Skip down to [Install Compose on Linux systems](#install-compose-on-linux-systems). |
There was a problem hiding this comment.
Why would you skip down to the Linux install section if you're on a desktop?
There was a problem hiding this comment.
arggh! :-) okay I'll fix it.
compose/install.md
Outdated
| If so, your `/usr/local/bin` directory probably isn't writable and | ||
| you'll need to install Compose as the superuser. Run `sudo -i`, then | ||
| run the download and install commands below, then `exit`. | ||
| On **Linux**, you can download the Docker Compose binary from the [Compose |
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
|
|
||
| 1. Install Docker Engine: | ||
| Docker Compose relies on Docker Engine for any meaningful work, so make sure you | ||
| have Docker Engine installed either locally or remote, depending on your setup. |
There was a problem hiding this comment.
@shin- Okay I'm not sure if this is well-worded to convey the right thing, but let me know what you think.
There was a problem hiding this comment.
yay! Here are some cute animal drawings.
Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
|
Brilliant! Thanks everyone, the topic is much better now. |
* clarify Compose install prerequisites Signed-off-by: Victoria Bialas <victoria.bialas@docker.com> * organized install on Microsoft Server into steps Signed-off-by: Victoria Bialas <victoria.bialas@docker.com> * better highlighting and organization for the desktop systems section Signed-off-by: Victoria Bialas <victoria.bialas@docker.com> * copyedit for consistency Signed-off-by: Victoria Bialas <victoria.bialas@docker.com> * changed Docker server --> Docker per review Signed-off-by: Victoria Bialas <victoria.bialas@docker.com> * attempt to clarify Compose / Docker Engine dependencies per reviews Signed-off-by: Victoria Bialas <victoria.bialas@docker.com> * copyedits per reviews Signed-off-by: Victoria Bialas <victoria.bialas@docker.com>
3 participants
What's changed
Related
#4126
Direct link to updated topic in Netlify preview
https://deploy-preview-4130--docker-docs-vnext-engine.netlify.com/compose/install/
Reviewers fyi
@mstanleyjones @barrystaes @shin- @dnephin
Signed-off-by: Victoria Binalas victoria.bialas@docker.com