Browse code

please, for the love of Docker, do. not. use. symlinks

Docker-DCO-1.1-Signed-off-by: Sven Dowideit <SvenDowideit@fosiki.com> (github: SvenDowideit)

Sven Dowideit authored on 2014/02/07 14:21:33
Showing 1 changed files
... ...
@@ -102,12 +102,17 @@ the ``-H`` flag for the client.
102 102
         docker ps
103 103
         # both are equal
104 104
 
105
-
106 105
 To run the daemon with `systemd socket activation <http://0pointer.de/blog/projects/socket-activation.html>`_, use ``docker -d -H fd://``.
107 106
 Using ``fd://`` will work perfectly for most setups but you can also specify individual sockets too ``docker -d -H fd://3``.
108 107
 If the specified socket activated files aren't found then docker will exit.
109 108
 You can find examples of using systemd socket activation with docker and systemd in the `docker source tree <https://github.com/dotcloud/docker/blob/master/contrib/init/systemd/socket-activation/>`_.
110 109
 
110
+.. warning::
111
+  Docker and LXC do not support the use of softlinks for either the Docker data directory (``/var/lib/docker``) or for ``/tmp``.
112
+  If your system is likely to be set up in that way, you can use ``readlink -f`` to canonicalise the links:
113
+
114
+  ``TMPDIR=$(readlink -f /tmp) /usr/local/bin/docker -d -D -g $(readlink -f /var/lib/docker) -H unix:// $EXPOSE_ALL > /var/lib/boot2docker/docker.log 2>&1``
115
+
111 116
 .. _cli_attach:
112 117
 
113 118
 ``attach``