Stop sharing /dev/shm and use --shm-size=1g

Author: elgalu

.travis.yml

@@ -40,7 +40,7 @@ matrix:
         - docker
       env:
         - DOCKER_VERSION="stable"
-          DOCKER_COMPOSE_VERSION="1.8.1"
+          DOCKER_COMPOSE_VERSION="1.8.0"
           DOCKER_PUSH=true
           DOCKER_PUSH_LATEST=true
     # Linux with docker:beta/older compose:beta/older
@@ -52,7 +52,7 @@ matrix:
         - docker
       env:
         - DOCKER_VERSION="1.12.2-rc2"
-          DOCKER_COMPOSE_VERSION="1.8.0"
+          DOCKER_COMPOSE_VERSION="1.8.1"
     # Linux with docker:stable compose:beta/older
     - os: linux
       language: python
@@ -62,7 +62,7 @@ matrix:
         - docker
       env:
         - DOCKER_VERSION="stable"
-          DOCKER_COMPOSE_VERSION="1.8.0"
+          DOCKER_COMPOSE_VERSION="1.8.1"
     # Linux with docker:beta/older compose:stable
     - os: linux
       language: python

README.md

@@ -72,7 +72,7 @@ You will need to run the second `eval` command for every new terminal window.
         docker pull elgalu/selenium #upgrades to latest if a newer version is available
 
         docker run -d --name=grid -p 4444:24444 -p 5900:25900 \
-            -e TZ="US/Pacific" -v /dev/shm:/dev/shm elgalu/selenium
+            -e TZ="US/Pacific" --shm-size=1g elgalu/selenium
 
 2. Wait until the grid starts properly before starting the tests _(Optional but recommended)_
 
@@ -105,15 +105,15 @@ Please google those errors first before opening an issue in this project.
 # capabilities['marionette'] = False
 docker run --rm -ti --name=grid2 -p 4444:24444 -p 5900:25900 \
   -e USE_SELENIUM=2 \
-  -v /dev/shm:/dev/shm elgalu/selenium
+  --shm-size=1g elgalu/selenium
 ```
 
 ### e.g. Selenium 3 with FF 49.0.1
 ```sh
 # capabilities['marionette'] = True
 docker run --rm -ti --name=grid3 -p 4444:24444 -p 5900:25900 \
   -e USE_SELENIUM=3 \
-  -v /dev/shm:/dev/shm elgalu/selenium
+  --shm-size=1g elgalu/selenium
 ```
 
 ### Docker Compose
@@ -133,7 +133,7 @@ This image is designed to run one test on each docker container but if you still
 1. The _(not recommended)_ way is by increasing `MAX_INSTANCES` and `MAX_SESSIONS` which now [defaults](https://github.com/elgalu/docker-selenium/blob/2.53.1a/Dockerfile#L967) to 1.
 
         docker run -d --name=grid -p 4444:24444 -p 5900:25900 \
-            -v /dev/shm:/dev/shm -e VNC_PASSWORD=hola \
+            --shm-size=1g -e VNC_PASSWORD=hola \
             -e MAX_INSTANCES=20 -e MAX_SESSIONS=20 \
             elgalu/selenium
 
@@ -157,7 +157,7 @@ You can also ssh into the machine as long as `SSH_AUTH_KEYS="$(cat ~/.ssh/id_rsa
     docker run --rm -ti --name=grid -p=4444:24444 -p=5900:25900 -p=22222:22222 \
       -e SSHD=true \
       -e SSH_AUTH_KEYS="$(cat ~/.ssh/id_rsa.pub)" \
-      -v /dev/shm:/dev/shm elgalu/selenium
+      --shm-size=1g elgalu/selenium
 
 Then
 
@@ -168,7 +168,7 @@ Include `-X` in ssh command if you want to redirect the started GUI programs to
     docker run --rm -ti --name=grid -p=4444:24444 -p=5900:25900 -p=22222:22222 \
       -e SSHD=true -e SSHD_X11FORWARDING=yes \
       -e SSH_AUTH_KEYS="$(cat ~/.ssh/id_rsa.pub)" \
-      -v /dev/shm:/dev/shm elgalu/selenium
+      --shm-size=1g elgalu/selenium
 
 Then
 
@@ -189,7 +189,7 @@ You can set a custom screen size at docker run time by providing `SCREEN_WIDTH`
     docker pull elgalu/selenium
 
     docker run -d --name=grid -p 4444:24444 -p 5900:25900 \
-      -v /dev/shm:/dev/shm -e VNC_PASSWORD=hola \
+      --shm-size=1g -e VNC_PASSWORD=hola \
       -e SCREEN_WIDTH=1920 -e SCREEN_HEIGHT=1480 \
       elgalu/selenium
 
@@ -202,7 +202,7 @@ You can control and modify the timezone on a container by using the [TZ](https:/
 
     docker run --rm -ti --name=grid -p 4444:24444 -p 5900:25900 \
         -e TZ="US/Pacific" -e VNC_PASSWORD=hola \
-        -v /dev/shm:/dev/shm elgalu/selenium
+        --shm-size=1g elgalu/selenium
 
 Examples:
 
@@ -269,7 +269,7 @@ Safari Browser already comes with a built-in vnc viewer so this feature is overk
 You need to pass the environment variable `-e NOVNC=true` in order to start the noVNC service and you will be able to open a browser at [localhost:6080](http://localhost:6080/vnc.html)
 
     docker run --rm -ti --name=grid -p 4444:24444 -p 5900:25900 \
-      -v /dev/shm:/dev/shm -p 6080:26080 -e NOVNC=true \
+      --shm-size=1g -p 6080:26080 -e NOVNC=true \
       elgalu/selenium
 
 If the VNC password was randomly generated find out with
@@ -283,7 +283,7 @@ If the VNC password was randomly generated find out with
 
 If your tests crashes in Chrome you may need to increase shm size or simply start your container by sharing `-v /dev/shm:/dev/shm` or, alternatively, `--shm-size=1g`
 
-    docker run ... -v /dev/shm:/dev/shm
+    docker run ... --shm-size=1g
 
 Alternatively you can increase it inside the container:
 
@@ -386,7 +386,7 @@ Host machine, terminal 1:
 Host machine, terminal 2:
 
     docker run --rm --name=ch -p=4444:24444 \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       -e SCREEN_WIDTH -e SCREEN_HEIGHT -e XE_DISP_NUM \
       -v /tmp/.X11-unix/X${XE_DISP_NUM}:/tmp/.X11-unix/X${XE_DISP_NUM} \
       elgalu/selenium
@@ -468,14 +468,14 @@ So `--pid=host` is included to avoid https://github.com/docker/docker/issues/589
 Full example using `--net=host` and `--pid=host` but for this to work in OSX you need the latest docker mac package, upgrade if you haven't done so in the last month.
 
     docker run -d --name=grid --net=host --pid=host \
-      -v /dev/shm:/dev/shm -e SELENIUM_HUB_PORT=4444 \
+      --shm-size=1g -e SELENIUM_HUB_PORT=4444 \
       elgalu/selenium
     docker exec grid wait_all_done 30s
     ./test/python_test.py
 
 #### DNS example
 
-    docker run -d --net=host --pid=host --name=grid -v /dev/shm:/dev/shm elgalu/selenium
+    docker run -d --net=host --pid=host --name=grid --shm-size=1g elgalu/selenium
     docker exec grid wait_all_done 30s
 
 ## Who is using docker-selenium?

docs/hub_and_nodes.md

@@ -30,7 +30,7 @@ Chrome will also attach to the `host` network interface.
       -e GRID=false -e CHROME=true -e FIREFOX=false \
       -e VNC_START=false -e PICK_ALL_RANDMON_PORTS=true \
       -e SELENIUM_HUB_PORT=4444 \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium
 
 ![docker-selenium-chrome-node](../images/chrome_grid_console.png)
@@ -39,7 +39,7 @@ Chrome will also attach to the `host` network interface.
       -e GRID=false -e CHROME=true -e FIREFOX=false \
       -e VNC_START=false -e PICK_ALL_RANDMON_PORTS=true \
       -e SELENIUM_HUB_PORT=4444 \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium
 
 ### Firefox
@@ -49,7 +49,7 @@ Firefox will also attach to the host machine network interface.
       -e GRID=false -e CHROME=false -e FIREFOX=true \
       -e VNC_START=false -e PICK_ALL_RANDMON_PORTS=true \
       -e SELENIUM_HUB_PORT=4444 \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium
 
 ![docker-selenium-firefox-node](../images/firefox_grid_console.png)
@@ -58,7 +58,7 @@ Firefox will also attach to the host machine network interface.
       -e GRID=false -e CHROME=false -e FIREFOX=true \
       -e VNC_START=false -e PICK_ALL_RANDMON_PORTS=true \
       -e SELENIUM_HUB_PORT=4444 \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium
 
 ### Wait

docs/hub_and_nodes_alternatives.md

@@ -48,7 +48,7 @@ The placeholder `{{CONTAINER_IP}}` will be turned into the IP address of the con
       -e VNC_START=false -e PICK_ALL_RANDMON_PORTS=true \
       -e SELENIUM_HUB_PORT=4444 -e SELENIUM_HUB_HOST="hub.seleniums" \
       -e SELENIUM_NODE_HOST="{{CONTAINER_IP}}" \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium
 
 ![docker-selenium-chrome-node](../images/chrome_grid_console.png)
@@ -58,7 +58,7 @@ The placeholder `{{CONTAINER_IP}}` will be turned into the IP address of the con
       -e VNC_START=false -e PICK_ALL_RANDMON_PORTS=true \
       -e SELENIUM_HUB_PORT=4444 -e SELENIUM_HUB_HOST="hub.seleniums" \
       -e SELENIUM_NODE_HOST="{{CONTAINER_IP}}" \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium
 
 ### Firefox
@@ -69,7 +69,7 @@ Firefox will also attach to the `seleniums` network interface.
       -e VNC_START=false -e PICK_ALL_RANDMON_PORTS=true \
       -e SELENIUM_HUB_PORT=4444 -e SELENIUM_HUB_HOST="hub.seleniums" \
       -e SELENIUM_NODE_HOST="{{CONTAINER_IP}}" \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium
 
 ![docker-selenium-firefox-node](../images/firefox_grid_console.png)
@@ -79,7 +79,7 @@ Firefox will also attach to the `seleniums` network interface.
       -e VNC_START=false -e PICK_ALL_RANDMON_PORTS=true \
       -e SELENIUM_HUB_PORT=4444 -e SELENIUM_HUB_HOST="hub.seleniums" \
       -e SELENIUM_NODE_HOST="{{CONTAINER_IP}}" \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium
 
 ### Wait
@@ -133,7 +133,7 @@ Port numbers are completely arbitrary, VNC port will be `5940` and Selenium node
       -e SELENIUM_HUB_HOST="{{CONTAINER_IP}}" \
       -e SELENIUM_HUB_PORT=4444 \
       -e SELENIUM_NODE_HOST="{{CONTAINER_IP}}" \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium && docker exec node_ch wait_all_done 30s
 
 The important part above is `-e GRID=false` which tells the container to be a node-only node, this this case with 2 browsers `-e CHROME=true -e FIREFOX=true` but could be just 1.
@@ -149,5 +149,5 @@ Port numbers are completely arbitrary, VNC port will be `5940` and Selenium node
       -e SELENIUM_HUB_HOST="{{CONTAINER_IP}}" \
       -e SELENIUM_HUB_PORT=4444 \
       -e SELENIUM_NODE_HOST="{{CONTAINER_IP}}" \
-      -v /dev/shm:/dev/shm \
+      --shm-size=1g \
       elgalu/selenium && docker exec node_ff wait_all_done 30s

docs/videos.md

@@ -11,7 +11,7 @@ Pull image
 Run a new grid
 
     docker run --rm --name=grid -p 4444:24444 -p 5920:25900 \
-      -v /dev/shm:/dev/shm -e VNC_PASSWORD=hola \
+      --shm-size=1g -e VNC_PASSWORD=hola \
       -e VIDEO=true elgalu/selenium
 
 ### Wait

images/grid2_console.png

@@ -3,7 +3,7 @@ Miscellaneous internal notes, do not read!
 ## Build
 
     time (docker build -t elgalu/selenium . ;echo $?;beep)
-    docker run --rm -ti --name=local -e SELENIUM_HUB_PORT=5555 -p=5555:5555 -p=5900:25900 -e VIDEO=true -e VNC_PASSWORD=no -v /dev/shm:/dev/shm elgalu/selenium
+    docker run --rm -ti --name=local -e SELENIUM_HUB_PORT=5555 -p=5555:5555 -p=5900:25900 -e VIDEO=true -e VNC_PASSWORD=no --shm-size=1g elgalu/selenium
 
 ### Wait
 Wait and get versions
@@ -25,7 +25,7 @@ Push setup, first time only:
 
 Build a grid with extra nodes
 
-    docker run --rm --name=local -p 4444:24444 -p 5900:25900 -v /dev/shm:/dev/shm -e VNC_PASSWORD=hola elgalu/selenium
+    docker run --rm --name=local -p 4444:24444 -p 5900:25900 --shm-size=1g -e VNC_PASSWORD=hola elgalu/selenium
 
     docker run --rm --name=node -e DISP_N=13 -e SSHD_PORT=22223 -e SUPERVISOR_HTTP_PORT=29003 -e VNC_PORT=25903 -e SELENIUM_NODE_CH_PORT=25330 -e SELENIUM_NODE_FF_PORT=25331 -e GRID=false -e CHROME=true -e FIREFOX=true --net=container elgalu/selenium
 

images/grid3_console.png

@@ -50,7 +50,7 @@ export MOCK_SERVER_PORT=$(get_mock_port)
 docker run --name=grid -d -e VIDEO=true \
   -e MOCK_SERVER_HOST="d.host.loc.dev" \
   -e MOCK_SERVER_PORT \
-  -v /dev/shm:/dev/shm \
+  --shm-size=1g \
   selenium
   # -v /var/run/dbus:/var/run/dbus \
 
@@ -79,7 +79,7 @@ docker run --name=grid3 -d -e VIDEO=true \
   -e MOCK_SERVER_HOST="d.host.loc.dev" \
   -e MOCK_SERVER_PORT \
   -e USE_SELENIUM="3" \
-  -v /dev/shm:/dev/shm \
+  --shm-size=1g \
   selenium
 
 sleep 0.5 && docker logs grid3

misc/misc.md

@@ -45,7 +45,7 @@ docker rm -vf grid_mock || true
 docker run --name=mynodes -d \
   -e FIREFOX=false \
   -e SELENIUM_NODE_CH_PORT -p ${SELENIUM_NODE_CH_PORT}:${SELENIUM_NODE_CH_PORT} \
-  -v /dev/shm:/dev/shm \
+  --shm-size=1g \
   selenium
   # -v /var/run/dbus:/var/run/dbus \