Switching over to native docker application on mac will break IntelliJ docker integration. Original integration was built around docker-machine/docker-compose and requires docker API URL to be set.

How to enable docker beta with intellij on OSX

Docker integration in IntelliJ supports several URI schemes: tcp/unix or even http/https. With native docker application, they don't work.

Setting up tcp or http/https does not work as docker host (docker.local) is not available since beta9, on the other hand setting up API URL to unix socket:


fails with this error:

The solution (more of a hack then solution, until docker integration gets updated in IntelliJ) is rather simple:

  1. Install socat command brew install socat
  2. Choose a port (in the example 8099)
  3. Run socat -d -d TCP-L:8099,fork UNIX:/var/run/docker.sock

Command is rather verbose, for debugging purposes, but you can also reduce verbosity by removing two "-d" parameters:

socat TCP-L:8099,fork UNIX:/var/run/docker.sock

Once that's up and running, set API URL in IntelliJ to:


It should be able to connect:

and images should be visible after closing dialog and connecting:

Happy hacking!