memcached/README.md

   1 Run this [Memcached][] image with:
   2
   3     $ docker run -d --name memcached-0 -m 128m -e MEMUSAGE=118 wking/memcached
   4
   5 The 10MB difference between container memory and the
   6 Memcached-specific `MEMUSAGE` limit gives some overhead for the
   7 `memcached` process itself and auxilliary processes to ensure that
   8 `MEMUSAGE` stops us before we hit “out of memory” errors.
   9
  10 Then [link][linking] to it from your client container:
  11
  12     $ docker run --link memcached-0:memcached your-client
  13
  14 Inside your client, use the `MEMCACHED_PORT` environment variable
  15 (which should be something like `tcp://172.17.0.8:11211`) to configure
  16 your client's Memcached connection.  Linking like this *does not*
  17 expose the port on your host interface (that's what `-p` is for).  You
  18 can spin up as many Memcached containers as you like (`memcached-1`,
  19 `memcached-2`, …), and link to any of them from any client container.
  20
  21 [Memcached]: http://memcached.org/
  22 [linking]: http://docs.docker.io/en/latest/use/port_redirection/#linking-a-container