All settings can be changed from both the command line (
orb config) and the app (in Settings).
Use Rosetta to run Intel code
On Apple Silicon, this controls whether to use Rosetta for emulating Intel code (also known as x86, x86_64, AMD64, or
linux/amd64). Rosetta is much faster than the slower fallback used when this setting is disabled, so we recommend leaving it enabled unless you run into compatibility issues.
OrbStack includes many fixes for common Rosetta bugs that affect other solutions, so it's unlikely that you'll run into any issues with this enabled. If you do, please let us know.
Note that this option can have a slight performance hit on all programs running in OrbStack, including native ARM code, but it's usually not noticeable.
The total amount of memory that containers and machines running in OrbStack are allowed to use. Memory is taken from Mac on demand, but once used, it cannot be released without restarting OrbStack due to a macOS bug.
If you're getting "Out of memory" notifications, try increasing the memory limit. It is set to no more than 8 GB by default.
The percentage of CPU that containers and machines running in OrbStack are allowed to use.
This is not a reservation. Unlike memory, OrbStack only uses as much CPU as your programs use.
(The CLI accepts an integer multiple of 100% instead.
7 is equivalent to
700% in the app.)
Hide OrbStack volume
If enabled, the "OrbStack" mount, which provides access to volumes and machine files from macOS, will be hidden from the Desktop and the Finder sidebar. It will still be accessible at
Settings for OrbStack's Docker engine.
For compatibility, containers only use IPv4 by default. Enable this if you need IPv6.
This allows you to change advanced configuration options. See Docker's documentation for more information.
Allow access to container domains & IPs
You can safely leave it enabled even if you don't need it.
In some cases, the IP ranges or subnets used for container and machines could conflict with your VPN or other networks. OrbStack will automatically disable this feature if it detects a conflict.
To resolve the conflict, change the container IP ranges. Linux machine IP ranges cannot be changed.
OrbStack uses your default system-wide proxy server by default.
To set a custom HTTP, HTTPS, or SOCKS proxy server URL, see Proxies for more information.
Clear Docker data
To reset and delete Docker data, use
orb delete docker.
Clear all data
You can also reset and delete all data (i.e. factory reset) with
orb reset. This includes all Docker data and Linux machines.