Merge pull request #546 from cytopia/docs-troubleshooting

Docs troubleshooting

Author: cytopia

.devilbox/www/config.php

@@ -14,7 +14,7 @@
 
 
 $DEVILBOX_VERSION = 'v0.15.0';
-$DEVILBOX_DATE = '2019-03-09';
+$DEVILBOX_DATE = '2019-03-18';
 $DEVILBOX_API_PAGE = 'devilbox-api/status.json';
 
 //

CHANGELOG.md

@@ -94,6 +94,7 @@ major versions.
 - PHP-FPM workers changed from `dynamic` to `ondemand`
 - Allow Apache to server underscore domains
 - Changed Nginx `client_max_body_size` to `0` to be in sync with Apache
+- Document failing start behaviour of MySQL container
 
 #### Fixed
 - break on errors in wrong vhost-gen overwrite

docs/support/troubleshooting.rst

@@ -110,6 +110,27 @@ A few general things you should always do before attempting to open up issues ar
    that are shared by Docker. If not add those in the Docker settings.
 
 
+No Space left on Device
+-----------------------
+
+If on Docker for Mac you get an error during docker pull similar to the following one:
+
+.. code-block:: bash
+
+   write /var/lib/docker/tmp/GetImageBlob220119603: no space left on device
+
+It means the file where MacOS stores the docker images is full. The usual way is to delete
+unused images and volumes to free up space or increase this volumes size.
+
+However, depending on the version of Docker some of the above suggestions may not work and you
+have to get support from the docker/for-mac GitHub repository or forum.
+
+.. seealso::
+   * https://github.com/cytopia/devilbox/issues/539
+   * https://github.com/docker/for-mac/issues/371#issuecomment-242047368
+   * https://forums.docker.com/t/no-space-left-on-device-error/10894
+
+
 Address already in use
 ----------------------
 
@@ -287,6 +308,15 @@ To mitigate that issue, make sure that the ``swoole`` module is disabled in ``.e
 Database issues
 ===============
 
+Cannot connect to MySQL after restart
+-------------------------------------
+
+This error usually occurs when you import a MySQL dump including the mysql database itself, which
+will overwrite the user permissions and thus you won't be able to connect anymore with the settings
+specified in ``.env``.
+
+.. seealso:: https://github.com/cytopia/devilbox/issues/542
+
 Invalid bind mount spec
 -----------------------