Skip to content

Latest commit

 

History

History
79 lines (51 loc) · 2.67 KB

how-do-i-use-orbstack.md

File metadata and controls

79 lines (51 loc) · 2.67 KB
title description guide authors updated
Using Lando with Orbstack
Learn how to use Lando with Orbstack today.
true
timestamp
1770760290

Using Lando with Orbstack

Orbstack is a lightweight and ⚡️ lightning-fast Docker provider that can serve as a drop-in replacement for Docker Desktop. It is an excellent alternative for users who want to use Lando without Docker Desktop.

Switching from Docker Desktop is 100% seamless: just open OrbStack and get started.

Official support for swapping Docker providers will be available in Lando 4. In the meantime, you can use Orbstack as a drop-in replacement.

After installing Lando, follow these steps:

1. Kill all running containers and close Docker Desktop

Ensure that auto-start is disabled in Docker Desktop settings. You can stop all containers by running:

lando poweroff && docker stop $(docker ps -a -q)

2. Install Orbstack

brew install orbstack

3. Create a symbolic link for Docker.app (if needed)

Lando checks for the presence of Docker.app, but doesn't actually require Docker Desktop to be installed or running. If you want to completely remove Docker Desktop, you can create a symbolic link from Orbstack to Docker.app:

sudo ln -s /Applications/OrbStack.app /Applications/Docker.app

This tricks Lando into thinking Docker.app is present, while Orbstack handles all the Docker CLI commands seamlessly.

Note: By opening Orbstack, it binds the necessary Docker CLI commands that Lando expects and uses. This allows you to run Lando without relying on Docker Desktop.

4. Migrating Existing Containers

Orbstack will automatically migrate your containers the first time you run lando start. If you prefer to migrate manually, run:

orb migrate docker

Additional Commands

Manually symlink Docker CLI to Orbstack (Optional)

docker context use orbstack

If you have admin access, OrbStack will automatically update the /var/run/docker.sock symlink to point to its own Docker engine. This improves compatibility with some third-party tools.

More info: https://docs.orbstack.dev/install#docker-migration

Reverting to Docker Desktop

If you want to switch back to Docker Desktop, run:

docker context use desktop-linux

For more detailed information on how to use Orbstack, please refer to the Orbstack documentation.

Enjoy extreme speed and performance with Orbstack! 🚀