Skip Docker socket bind for Colima/OrbStack

Author: gtsiolis

internal/runtime/docker.go

@@ -63,10 +63,22 @@ func probeSocket(candidates ...string) string {
 	return ""
 }
 
+// SocketPath returns the Unix socket path used by the Docker client.
+// Returns the actual path for the standard /var/run/docker.sock so callers
+// can bind-mount it into containers. Returns empty string for non-standard
+// sockets (Colima, OrbStack) which communicate with VMs and cannot be
+// bind-mounted. Called by internal/container/start.go to decide whether
+// to add a Docker socket bind-mount when starting LocalStack.
 func (d *DockerRuntime) SocketPath() string {
 	host := d.client.DaemonHost()
 	if strings.HasPrefix(host, "unix://") {
-		return strings.TrimPrefix(host, "unix://")
+		sock := strings.TrimPrefix(host, "unix://")
+		// Skip bind-mount for non-standard sockets (Colima, OrbStack, etc.)
+		// These sockets communicate with VMs and cannot be bind-mounted
+		if sock != "/var/run/docker.sock" {
+			return ""
+		}
+		return sock
 	}
 	return ""
 }

internal/runtime/docker_test.go

@@ -40,11 +40,26 @@ func TestProbeSocket_ReturnsEmptyForNoCandidates(t *testing.T) {
 }
 
 func TestSocketPath_ExtractsUnixPath(t *testing.T) {
-	cli, err := client.NewClientWithOpts(client.WithHost("unix:///home/user/.colima/default/docker.sock"))
-	require.NoError(t, err)
-	rt := &DockerRuntime{client: cli}
+	t.Run("standard socket returns path", func(t *testing.T) {
+		cli, err := client.NewClientWithOpts(client.WithHost("unix:///var/run/docker.sock"))
+		require.NoError(t, err)
+		rt := &DockerRuntime{client: cli}
+		assert.Equal(t, "/var/run/docker.sock", rt.SocketPath())
+	})
+
+	t.Run("non-standard socket returns empty", func(t *testing.T) {
+		cli, err := client.NewClientWithOpts(client.WithHost("unix:///home/user/.colima/default/docker.sock"))
+		require.NoError(t, err)
+		rt := &DockerRuntime{client: cli}
+		assert.Equal(t, "", rt.SocketPath(), "non-standard sockets should return empty to skip bind-mount")
+	})
 
-	assert.Equal(t, "/home/user/.colima/default/docker.sock", rt.SocketPath())
+	t.Run("orbstack socket returns empty", func(t *testing.T) {
+		cli, err := client.NewClientWithOpts(client.WithHost("unix:///Users/user/.orbstack/run/docker.sock"))
+		require.NoError(t, err)
+		rt := &DockerRuntime{client: cli}
+		assert.Equal(t, "", rt.SocketPath(), "non-standard sockets should return empty to skip bind-mount")
+	})
 }
 
 func TestSocketPath_ReturnsEmptyForTCPHost(t *testing.T) {

test/integration/start_test.go

@@ -168,6 +168,12 @@ func TestStartCommandSetsUpContainerCorrectly(t *testing.T) {
 			t.Skip("Docker daemon is not reachable via unix socket")
 		}
 
+		// Skip bind-mount assertion for non-standard sockets (Colima, OrbStack)
+		// since these communicate with VMs and cannot be bind-mounted
+		if dockerClient.DaemonHost() != "unix:///var/run/docker.sock" {
+			t.Skip("Docker daemon uses non-standard socket (Colima/OrbStack) - socket not bind-mounted")
+		}
+
 		assert.True(t, hasBindTarget(inspect.HostConfig.Binds, "/var/run/docker.sock"),
 			"expected Docker socket bind mount to /var/run/docker.sock, got: %v", inspect.HostConfig.Binds)