Settings ​

All settings can be changed from both the command line (orb config) and the app (in Settings).

System ​

Use Rosetta to run Intel code ​

Key: rosetta

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.

Memory limit ​

Key: memory_mib

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.

CPU limit ​

Key: cpu

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 ​

Key: mount_hide_shared

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 ~/OrbStack.

Docker ​

Settings for OrbStack's Docker engine.

IPv6 ​

For compatibility, containers only use IPv4 by default. Enable this if you need IPv6.

Engine config ​

This allows you to change advanced configuration options. See Docker's documentation for more information.

Network ​

Allow access to container domains & IPs ​

Key: network_bridge

This feature makes it possible to connect to containers directly from Mac using their IP address, without having to use port forwarding. This also includes Linux machine IPs

You can safely leave it enabled even if you don't need it.

IP conflicts ​

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.

Proxy ​

Key: network_proxy

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.

Storage ​

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.

Advanced ​

Hidden settings that can only be changed on the command line.

• ssh.expose_port: Allow devices on the LAN and other networks to connect to OrbStack's SSH server for Linux machines. Defaults to false.
• docker.node_name: Node name to use when joining a Swarm. Defaults to orbstack.