From 1d6c369c060e681addc9fd5e7c60c29aefa05a10 Mon Sep 17 00:00:00 2001 From: Winfried Date: Sun, 7 May 2017 15:17:25 +0200 Subject: [PATCH 1/3] Adding Docker version recommendation #895 --- DOCUMENTATION/content/getting-started/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/DOCUMENTATION/content/getting-started/index.md b/DOCUMENTATION/content/getting-started/index.md index f5b73aa..a3c1207 100644 --- a/DOCUMENTATION/content/getting-started/index.md +++ b/DOCUMENTATION/content/getting-started/index.md @@ -145,6 +145,10 @@ If you are using **Docker Toolbox** (VM), do one of the following:
+We recommend using a Docker version which is newer than 1.13. + +
+ >**Warning:** If you used an older version of Laradock it's highly recommended to rebuild the containers you need to use [see how you rebuild a container](#Build-Re-build-Containers) in order to prevent as much errors as possible.
From eab859fe80b808cf331636a9fabced097e58ae59 Mon Sep 17 00:00:00 2001 From: Winfried Date: Sun, 7 May 2017 15:18:09 +0200 Subject: [PATCH 2/3] Adding Docker-sync documenation #612 Closes #612 --- DOCUMENTATION/content/documentation/index.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/DOCUMENTATION/content/documentation/index.md b/DOCUMENTATION/content/documentation/index.md index 8db3ee3..49d1376 100644 --- a/DOCUMENTATION/content/documentation/index.md +++ b/DOCUMENTATION/content/documentation/index.md @@ -153,9 +153,28 @@ You might use the `--no-cache` option if you want full rebuilding (`docker-compo +
+ + +## Docker-Sync + +Docker on the Mac [is slow](https://github.com/docker/for-mac/issues/77), at the time of writing. Especially for larger projects, this can be a problem. The problem is [older than March 2016](https://forums.docker.com/t/file-access-in-mounted-volumes-extremely-slow-cpu-bound/8076) - as it's a such a long-running issue, we're including it in the docs here. + +The problem originates in bind-mount performance on MacOS. Docker for Mac uses osxfs by default. This is not without reason, it has [a lot of advantages](https://docs.docker.com/docker-for-mac/osxfs/). + +Solutions to resolve this issue are easily installed however, we're hoping it'll be fixed by Docker themselves over time. They are currently [adding "cached and delegated" options](https://github.com/docker/for-mac/issues/77#issuecomment-283996750), which is partly available for Docker Edge. + +Options are [to switch over to NFS](https://github.com/IFSight/d4m-nfs) which is the simplest. The fastest option is [Docker-Sync "native"](https://github.com/EugenMayer/docker-sync) which is still quite easy to install. + +Clone [this repo](https://github.com/EugenMayer/docker-sync-boilerplate) to your machine, copy `default/docker-sync.yml` to your Laradock directory and run `docker-sync-stack start`. Be sure to use `docker-sync-stack clean` to stop and `docker-compose build` to rebuild. More information can be found [in the Docker-sync docs](https://github.com/EugenMayer/docker-sync). + + + +
+ ## Add more Software (Docker Images) To add an image (software), just edit the `docker-compose.yml` and add your container details, to do so you need to be familiar with the [docker compose file syntax](https://docs.docker.com/compose/compose-file/). From 6db5bc016239036d9bdeb3e7a463a48f8adfa90e Mon Sep 17 00:00:00 2001 From: Winfried Date: Sun, 7 May 2017 15:18:26 +0200 Subject: [PATCH 3/3] Removing unfinished sentence --- DOCUMENTATION/content/getting-started/index.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/DOCUMENTATION/content/getting-started/index.md b/DOCUMENTATION/content/getting-started/index.md index a3c1207..0aba2e0 100644 --- a/DOCUMENTATION/content/getting-started/index.md +++ b/DOCUMENTATION/content/getting-started/index.md @@ -211,6 +211,4 @@ DB_HOST=mysql *If you want to install Laravel as PHP project, see [How to Install Laravel in a Docker Container](#Install-Laravel).*
-5 - Open your browser and visit your localhost address `http://localhost/`. If you followed the multiple projects setup, you can visit `http://project-1.dev/` and `http://project-2.dev/`. But first don't - - +5 - Open your browser and visit your localhost address `http://localhost/`. If you followed the multiple projects setup, you can visit `http://project-1.dev/` and `http://project-2.dev/`.