Skip to content

Instantly share code, notes, and snippets.

@jmeiracorbal
Created October 9, 2025 14:40
Show Gist options
  • Select an option

  • Save jmeiracorbal/4d3ddf0ae9120535c59b892dcf357d90 to your computer and use it in GitHub Desktop.

Select an option

Save jmeiracorbal/4d3ddf0ae9120535c59b892dcf357d90 to your computer and use it in GitHub Desktop.
Uninstall OrbStack from macOS and comeback to Docker Desktop
# unistall orbstack first
# if you install OrbStack, this app uses the same commands and replaces docker symlinks,
# if you uninstall it, the docker commands doesn't work. You need to restore the symlinks.
# remove old links orbstack
sudo rm -f /usr/local/bin/docker /usr/local/bin/docker-compose /usr/local/bin/docker-buildx /usr/local/bin/docker-credential-desktop
# create new links to docker desktop
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker /usr/local/bin/docker
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker-compose /usr/local/bin/docker-compose
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker-buildx /usr/local/bin/docker-buildx
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker-credential-desktop /usr/local/bin/docker-credential-desktop
# reload shell config (if you use bash, reload your bashrc)
source ~/.zprofile
# check if docker is running
docker --version
docker ps
@jmeiracorbal
Copy link
Author

If you have plugins, orbstack replaces this links too. You need to restore:

# delete orbstack links
sudo rm -f /usr/local/bin/docker
sudo rm -f /usr/local/bin/docker-compose
sudo rm -f /usr/local/bin/docker-buildx
sudo rm -f /usr/local/bin/docker-credential-osxkeychain

# create docker desktop links (if you use another system, replace the path):
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker /usr/local/bin/docker
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker-compose /usr/local/bin/docker-compose
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker-buildx /usr/local/bin/docker-buildx

# create links to credentials server:
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker-credential-desktop /usr/local/bin/docker-credential-desktop
# another options: docker-credential-osxkeychain, docker-credential-ecr-login. Check /usr/local/bin/docker-credential-ecr-login.

# reload your bash:
source ~/.zprofile
# source ~/.bashrc

# check if it works
docker --version
# Usage: docker-credential-osxkeychain <store|get|erase|list|version>
docker-credential-osxkeychain

@JanStorm
Copy link

in my case i had some links left, this is how i handled them:

# delete orbstack links
sudo rm -f /usr/local/bin/orb
sudo rm -f /usr/local/bin/orbctl

# replace links with docker desktop
sudo rm -f /usr/local/bin/kubectl
sudo ln -s /Applications/Docker.app/Contents/Resources/bin/kubectl /usr/local/bin/kubectl

# use this to check if there are any Orbstack links left:
ls -lat /usr/local/bin | grep OrbStack

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment