{"id":18598,"date":"2025-04-10T10:18:18","date_gmt":"2025-04-10T10:18:18","guid":{"rendered":"http:\/\/www.max-sperling.bplaced.net\/?p=18598"},"modified":"2025-04-15T15:10:51","modified_gmt":"2025-04-15T15:10:51","slug":"switch-between-docker-platforms-macos","status":"publish","type":"post","link":"http:\/\/www.max-sperling.bplaced.net\/?p=18598","title":{"rendered":"Switch between docker platforms (macOS)"},"content":{"rendered":"

Introduction<\/strong><\/p>\n

Docker Engine<\/u> … Client-server application<\/p>\n

\r\nDocker CLI <--[ Unix domain socket ]--> Docker daemon\r\n  (docker)      (Docker REST API)       (dockerd)\r\n<\/pre>\n
Docker Desktop \/ OrbStack<\/u> … Superset of Docker Engine<\/p>\n
\r\n                                              |   Linux VM    |\r\n    Docker CLI <--|                           |---------------|\r\n                  |--[ Unix domain socket ]-->| Docker daemon |\r\nDocker Desktop <--|                           |---------------|\r\nor OrbStack GUI\r\n<\/pre>\n
Motivation<\/u>
\nIf you have installed multiple Docker platforms (Docker Desktop, OrbStack) on your macOS, you most likely want to switch between them.<\/p>\n
\n
Switch the Docker CLI<\/strong><\/p>\n
Scenario<\/u>
\nYou are using the console to interact with docker. To switch the Docker CLI, you have to switch the symlink.<\/p>\n
Bash script<\/u><\/p>\n
\r\n#!\/bin\/bash\r\n\r\nDOCKER_SYMLINK="\/usr\/local\/bin\/docker"\r\nORBSTACK="\/Applications\/OrbStack.app\/Contents\/MacOS\/xbin\/docker"\r\nDOCKER_DESKTOP="\/Applications\/Docker.app\/Contents\/Resources\/bin\/docker"\r\n\r\nfunction usage() {\r\n    echo "Usage: $0 [orbstack|desktop|status]"\r\n    exit 1\r\n}\r\n\r\nfunction switch_to_orbstack() {\r\n    sudo ln -sf "$ORBSTACK" "$DOCKER_SYMLINK"\r\n    echo "Switched Docker CLI to OrbStack."\r\n}\r\n\r\nfunction switch_to_desktop() {\r\n    sudo ln -sf "$DOCKER_DESKTOP" "$DOCKER_SYMLINK"\r\n    echo "Switched Docker CLI to Docker Desktop."\r\n}\r\n\r\nfunction show_status() {\r\n    TARGET=$(readlink "$DOCKER_SYMLINK")\r\n    echo "Current symlink: $DOCKER_SYMLINK -> $TARGET"\r\n    if [[ "$TARGET" == "$ORBSTACK" ]]; then\r\n        echo "Currently using: OrbStack."\r\n    elif [[ "$TARGET" == "$DOCKER_DESKTOP" ]]; then\r\n        echo "Currently using: Docker Desktop."\r\n    else\r\n        echo "Currently using: Unknown target."\r\n    fi\r\n}\r\n\r\ncase "$1" in\r\n    orbstack)\r\n        switch_to_orbstack\r\n        ;;\r\n    desktop)\r\n        switch_to_desktop\r\n        ;;\r\n    status)\r\n        show_status\r\n        ;;\r\n    *)\r\n        usage\r\n        ;;\r\nesac\r\n<\/pre>\n
\n
Switch the Unix domain socket<\/strong><\/p>\n
Scenario<\/u>
\nYou are using a Docker toolchain with an IDE like CLion (JetBrains). To switch the used Unix domain socket, you have to change the toolchain settings.<\/p>\n
Sockets<\/u><\/p>\n
\r\nDocker Desktop: \/Users\/{user}\/.docker\/run\/docker.sock\r\nOrbStack: \/Users\/{user}\/.orbstack\/run\/docker.sock\r\n<\/pre>\n
For CLion<\/u><\/p>\n
    \n
  1. \"Settings\" --> \"Build, Execution, Deployment\" --> \"Toolchains\"<\/li>\n
  2. Change \"Docker for mac\" in \"Server\" settings<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
    Introduction Docker Engine … Client-server application Docker CLI Docker daemon (docker) (Docker REST API) (dockerd) Docker Desktop \/ OrbStack …<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false},"categories":[82],"tags":[],"_links":{"self":[{"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=\/wp\/v2\/posts\/18598"}],"collection":[{"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=18598"}],"version-history":[{"count":23,"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=\/wp\/v2\/posts\/18598\/revisions"}],"predecessor-version":[{"id":18631,"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=\/wp\/v2\/posts\/18598\/revisions\/18631"}],"wp:attachment":[{"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=18598"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=18598"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.max-sperling.bplaced.net\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=18598"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}