Skip to content

What's new ​

Download the latest version

We're hiring!

v1.5.1 (Apr 1) ​

πŸ“• Read the blog post

✨ Please spread the word if you like OrbStack!

  • Downgraded xz to fix potential security issues
    • OrbStack was not vulnerable to CVE-2024-3094
  • Confirmation prompt for deleting containers
  • Fixed Rosetta installation request even if disabled
  • Fixed old NixOS machines failing to upgrade
  • Fixed old SQL Server crashing with SIGABRT
  • Fixed button tooltips not appearing on hover
  • Debug Shell: Removed warning when working directory doesn't exist
  • Debug Shell: Colorful ip output

v1.5.0 (Mar 21) ​

  • New: OrbStack Debug Shell
    • Useful commands & tools to easily debug any container (even minimal/distroless/read-only)
    • Install over 80,000 packages
    • Everyone has a free 30-day Pro trial for Debug Shell
  • Faster & more reliable access to container/image/volume/machine files
  • Fixed OrbStack starting automatically with VS Code C++ extension
  • Fixed invalid hosts in VS Code Remote SSH sidebar
  • Fixed crash on some unexpected network packets
  • Fixed deletion of machines with swapfiles
  • Fixed "No space left on device" and related crashes
  • Fixed shared folder name on macOS 14.4
  • Fixed new machine creation for NixOS unstable
  • General performance improvements
  • UI: Compose groups stay expanded across restart
  • UI: Support for multiple containers in Kubernetes pod logs
  • UI: Gray dot for paused containers
  • UI: Consistent location for container actions
  • UI: Fixed error dialogs not fitting on screen
  • UI: Fixed high CPU usage when errors occur in the background
  • CLI: -w flag for working directory
  • Kernel features: TIPC, conntrack zones (support for Kuma)
  • Machines: support for CRIU
  • Fixed CVE-2024-29018
  • Updates: Docker 25.0.4, buildx 0.13.1, Linux 6.7.10, openEuler 23.09

v1.4.3 (Feb 13) ​

  • Full fix for CVE-2024-21626
  • Fixed app sign-in sometimes not working
  • Updates: Docker 25.0.3

v1.4.2 (Feb 6) ​

  • Support for bind-mounting non-standard macOS paths
  • Fixed UI incorrectly showing "Personal use only" in some cases
  • Fixed some images with extended attributes failing to import
  • Fixed incorrect error messages when image import fails
  • Fixed mounting SSH_AUTH_SOCK into containers

v1.4.1 (Feb 2) ​

  • Minor UI tweaks
  • Fixed missing command-line tools in some installs
  • Fixed SSH config parsing errors

v1.4.0 (Feb 2) ​

  • High severity security fixes for Docker Engine, runc, BuildKit
  • New UI design to show more details
  • Shell completions for docker and kubectl
  • orb.local domains now work across Compose projects
  • Create machines with custom usernames
  • Change default username for each machine
  • Added X-Forwaded-For to HTTPS proxy
  • Support for multi-level wildcard domains
  • Fixed some ANSI escapes appearing in logs
  • Fixed unnecessary Kubernetes restarts
  • Fixed Rosetta install process

v1.3.0 (Dec 28) ​

  • Cloud-init for Linux machines
    • Easily replicate & test environments with user data, like EC2
  • Kubernetes cluster.local domains
    • Allows connecting to headless services
  • Smoother migration from Docker Desktop
  • Advanced setting to change Docker Swarm node name
  • Advanced setting to expose SSH server to LAN
  • Fixed compatibility with JetBrains Docker plugins
  • Fixed emulated Arch x86 machines on Apple Silicon
  • Fixed unreliable domains on newer macOS 14 releases

v1.2.0 (Dec 20) ​

πŸ“• Read the blog post

  • Native container files access from Finder & Terminal
    • View & edit files in containers with your favorite tools
  • Added option to disable wrapping in logs UI
  • Added support for vhost-net
  • Fixed complex volume migration from Docker Desktop
  • Fixed DNS memory leak and high CPU usage
  • Fixed file watchers not working in /tmp
  • Fixed host connections timing out under high load
  • Fixed IPv6 compatibility issues with some containers
  • Fixed Kubernetes DNS crashing under heavy load
  • Fixed rare SSH connection failures
  • Fixed rebuilt image contents not updating on macOS side
  • Fixed Yarn, AppImages, and Swift under x86 emulation
  • Support for connecting to any port via HTTP proxy
  • Support for emulating RISC-V, PowerPC, MIPS, and IBM Z
  • Updates: Compose 2.23.3, buildx 0.12.0, Linux 6.5.13

v1.1.0 (Nov 16) ​

πŸ“• Read the blog post

  • Automatic HTTPS for containers & services
    • Secure, zero-setup HTTPS for all domains
  • Better x86 performance on macOS 14.1+
  • Copyable port numbers in container info
  • Machines can now be started from the menu bar
  • Better credential store coexistence with Docker Desktop
  • Fixed DNS memory leak in some error cases
  • Fixed crash when switching tabs quickly
  • Fixed VS Code not connecting in new Alma machines
  • Updates: Docker 24.0.7, Linux 6.5.10, Ubuntu 23.10, Fedora 39, Debian 13 (testing)
  • Other bug fixes and improvements

v1.0.1 (Oct 12) ​

  • Fixed x86 programs crashing on macOS 14 Sonoma
    • Workaround for Apple bug
  • Remaining Pro (commercial) trial days are now shown in the app
  • Separate UI sections for in-use/unused/dangling images
  • Support for opening Warp terminal
  • Support for GENEVE tunnels
  • NAT traversal fixes for Tailscale
  • More reliable traceroute
  • Fixed migration getting stuck and failing on some containers
  • Fixed OrbStack app preventing shutdown/restart
  • Fixed uppercase domain names not working
  • Fixed some memory leaks
  • Updates: Compose 2.22.0, Linux 6.5.7
  • Other bug fixes and improvements

πŸŽ‰ v1.0 (Sep 21) ​

OrbStack 1.0 is here ​

It's the long-awaited release! See the blog post

Licenses are now required for freelance, business, and commercial use.

Other changes since beta ​

  • Default update channel is now Stable
  • For faster updates, opt in to Canary in Settings
  • Better handling of domain name conflicts
  • Fixed service occasionally getting stuck while stopping
  • Fixed shared volumes disappearing in rare cases
  • Compatibility fix for IBM DB2
  • Other bug fixes and improvements

Hotfix 16230 ​

  • Fixed issues with accounts and licenses when updating from beta

v0.17.3 (Sep 13) ​

  • Fixed GUI getting stuck on "Loading" in some cases
  • Fixed Rosetta installation on new Macs
  • Fixed crash on start when disk is almost full
  • Higher maximum memory limit on high-RAM Macs
  • Faster startup with lower CPU usage
  • Updates: Linux 6.4.16
  • Other bug fixes and improvements

v0.17.2 (Sep 11) ​

  • Faster and more stable UI
  • Filter Compose project logs to a set of services
  • Start containers & projects from the menu bar
  • Simple switch to start and stop Kubernetes
  • More menu bar features & actions
  • Slightly lower memory usage
  • More reliable updating and restarting
  • Fixed domains not working in some cases
  • Fixed some web frameworks not reloading on file changes
  • Fixed rare freezes under high I/O
  • Fixed occasional UI crashes
  • Updates: Docker Engine 24.0.6, Linux 6.4.15
  • Other bug fixes and improvements

v0.17.1 (Aug 31) ​

  • One-click button to open Kubernetes services in browser
  • Faster start/stop/delete actions in GUI
  • Fixed port forwarding issues
  • Potential stability improvements under high I/O
  • Support for CAN bus (SocketCAN and virtual CAN)
  • Support for IPVLAN and IPIP tunnels
  • Support for bind-mounting /opt/homebrew
  • Updates: Compose 2.21.0, Linux 6.4.13
  • Other bug fixes and improvements

v0.17.0 (Aug 29) ​

  • First-class Kubernetes support
    • Seamless network: Connect to pods, ClusterIPs, Ingress directly
    • Battery friendly: Up to 80% less power usage
    • Native macOS UI
  • More reliable container domains
  • More efficient container port forwards (up to 30% less CPU)
  • General system performance improvements
  • Security improvements against malicious machines
  • FIPS support for builtin SSH server (ECDSA and RSA)
  • Fixed container logs UI on macOS 12
  • Updates: Linux 6.4.11, Devuan 5
  • Other bug fixes and improvements

v0.16.1 (Aug 17) ​

  • Direct access to container image files from Mac
    • Explore Docker images with Finder and other tools
  • Helper tool to avoid asking for password more than once
  • Better port detection for container domains
  • Option to stop requesting admin privileges
  • Offline licensing support for up to 7 days
  • Fixed some self-signed certificates not being trusted
  • Fixed new machines not showing up in /mnt/machines
  • Rosetta bug fixes
  • Updates: Linux 6.4.10
  • Other bug fixes and improvements

v0.16.0 (Aug 10) ​

  • Automatic domain names for containers
    • Zero config, no port numbers needed
    • Support for custom domains and wildcards
  • New logs UI with search and tabs for Compose projects
  • Added button to reset data from settings UI
  • Better network compatibility
  • Fixed segfaults in some emulated x86 builds
  • Fixed migration for some x86 containers and images
  • Fixes for build cache cleaning and SSH agent forwarding
  • Fixed emulated Arch Linux machine creation
  • Support for mounting localtime in containers
  • Updates: Linux 6.4.8
  • Other bug fixes and improvements

v0.15.1 (July 30) ​

  • Automatic deletion of unused build cache (can save 200+ GB)
  • Faster Docker shutdown and machine deletion
  • More reliable file watcher & live reload support
  • Minor performance improvements for some workloads
  • Added option to leave Docker context unchanged
  • Support for emulating AVX (when Rosetta is off)
  • Fixed migration from older versions of Docker Desktop
  • Fixed modprobe errors (for Istio, K3s, etc.)
  • Fixed rare storage-related startup errors
  • Fixed freezes under some heavy UDP workloads
  • Fixed compressed executables failing under Rosetta
  • Updates: Docker 24.0.5, Linux 6.4.7
  • Other bug fixes and improvements

v0.15.0 (July 23) ​

  • Automatic data migration from Docker Desktop (containers, etc.)
  • Send feedback from the app
  • Simplified bug reporting
  • More reliable port forwarding
  • Better support for proxy exclusions (domains, IP subnets)
  • Fixed PHP segfaults under Rosetta
  • Fixed timeouts when accessing Docker volumes from Mac
  • Fixed occasional crashes when running Chromium
  • Fixed Alpine and Void creation with unusual usernames/UIDs
  • UI fixes, design tweaks, silent notifications
  • Updates: Debian 12, Compose 2.20.2, Linux 6.3.13
  • Other bug fixes and improvements

v0.14.1 (July 12) ​

  • Fixed Docker not starting if updating with too many Compose networks
  • Fixed stability issues and file sharing crashes
  • Fixed repeated admin prompts on new Macs
  • Fixed hostname in new Ubuntu machines
  • Fixed "Operation not permitted" on bind-mounted devices
  • Fixed missing HOME environment for non-existent container UIDs
  • NixOS builder support for x86_64 on Apple Silicon

v0.14.0 (July 10) ​

All about performance and power saving.

  • Faster bind mounts with caching and optimizations
    • 3x faster search, 20x faster git status
  • 2x faster container start/stop
  • Lower energy usage when running heavy services and containers (up to 10x)
  • Fixed Node.js programs (e.g. pnpm) freezing under Rosetta
  • Better performance when macOS host is under load
  • Faster builds for Dockerfiles with many steps
  • Support for running 32-bit ARM programs
  • Support for renaming machines
  • Changed IP ranges to minimize conflicts
  • Fixes for bind mounts and other I/O
  • Updates: Docker 24.0.4, Compose 2.19.1, Linux 6.3.12
  • Other bug fixes and improvements

v0.13.0 (June 25) ​

A renewed focus on performance and stability.

  • Faster app start/stop and updating (up to 5x)
  • 2x faster container start/stop
  • Fixed most common Rosetta bugs
    • If you've disabled it, turn it back on to run x86 containers faster
  • Standard Docker IP ranges for compatibility (fixed SSL/authentication issues)
  • Better handling of IP conflicts with VPNs
  • Support for moving data to external drive
  • More reliable setup process
  • More resilient to power loss
  • Out-of-memory notifications
  • Support for running full x86 Docker engine with Rosetta
  • Fixed some complex Docker Compose setups getting stuck
  • Updates: Linux 6.3.9, Docker Compose 2.19.0
  • Other bug fixes and improvements

v0.12.0 (June 16) ​

  • Connect to Docker containers directly by IP address
    • Seamless bridge networks, no port forwarding needed
  • Connect to Linux machines by IP address (bridge network)
  • Log viewer improvements
  • Support for all CPU cores on M2 Ultra
  • Better UI performance with many containers/volumes/images
  • Fixed port forwards failing after Docker or machine restart
  • Fixed crashes after customizing toolbar
  • Updates: Linux 6.3.8, Docker 24.0.2, buildx 0.11.0, openSUSE 15.5
  • Bug fixes and other improvements

v0.11.3 (June 7) ​

  • Support for macOS 14 Sonoma Developer Beta (fixed crash)
  • SSH server: Support for adding authorized keys
  • Support for legacy docker.for.mac.localhost host
  • Updates: Linux 6.3.6, NixOS 23.05, Alpine Linux 3.18
  • Bug fixes and other improvements

v0.11.2 (June 1) ​

  • Added openEuler distro for machines
  • Added support for custom Docker hosts (e.g. port 2375)
  • Fixed excessive service restarts and updates
  • Fixed disabled "Apply" button in settings
  • Other bug fixes

v0.11.1 (May 29) ​

  • Menu bar status indicators for Compose services
  • Support for running commands in shell with -s
  • Better handling of out-of-memory scenarios
  • Fixed file watching on advanced volume-style bind mounts
  • Fixed occasional permission issues on write-intensive mounts
  • Fixed occasional AOSP build failures
  • Menu bar & updater fixes
  • Updates: Linux 6.3.4
  • Bug fixes and other improvements

v0.11.0 (May 23) ​

  • Menu bar app with quick actions
    • Manage containers & machines from anywhere
  • Hide icon from Dock
  • Discord community for feedback & help
  • Redesigned onboarding for new users
  • Better Docker UI design and usability
  • Simpler background service management
  • Updates: Docker Compose 2.18.1, buildx 0.10.5, Linux 6.1.29
  • Bug fixes and other improvements

v0.10.2 (May 15) ​

  • Fixed IPv6 UDP port forwarding
  • Fixed UDP servers in Docker host networking mode
  • Fixed UDP flows stopping after long periods of inactivity
  • Fixed GUI actions for invalid Docker Compose projects

v0.10.1 (May 10) ​

  • Distro version picker UI for Linux machines
  • Docker Compose projects are now shown above other containers
  • Better errors in Docker UI
  • Faster loading of long container log history
  • Fixed actions for deleted Compose projects
  • Fixed filtering for only running containers
  • Updates: Docker 23.0.6
  • Bug fixes and other UI improvements

v0.10.0 (May 7) ​

Even more GUI features!

  • Docker container logs
  • Docker Compose project groups in UI
  • Batch actions (multi-select) for containers, images, and volumes
  • Skip confirmation with Option-click
  • Distro updates: Ubuntu 23.04, Fedora 38
  • Bug fixes and other UI improvements

v0.9.0 (May 4) ​

Lots of work on the GUI app this time, with more to come!

  • Docker image management UI
  • Docker container, image, and volume search
  • Docker volume sizes and creation dates
  • Streamlined Docker container menus
  • Added option to hide "OrbStack" volume from Finder
  • Lower CPU usage after deleting a lot of files
  • Fixed system-wide HTTPS proxy support
  • Fixed delayed Docker UI updates in some cases
  • Bug fixes and other UI improvements

v0.8.1 (May 1) ​

  • New Docker config GUI
  • Live refresh for Docker GUI
  • Disabled Docker IPv6 by default for compatibility
  • Fixed permission errors when writing many small files as non-root users
  • Fixed occasional false-positive file watch creation events
  • Updates: Docker 23.0.5, Linux 6.1.27

v0.8.0 (Apr 26) ​

  • File watching & live reload support for Docker bind mounts
  • Faster network and better compatibility (up to 48 Gbps on M1)
  • Support for emulated arm64 Docker containers on Intel
  • Opt-in environment variable forwarding for machines
  • Support for Docker Swarm and Kubernetes IPVS
  • Fixed occasional "Failed to start VM" errors in UI
  • Fixed systemd distros in emulated Intel machines on macOS 12
  • Updates: Docker 23.0.4, Linux 6.1.26
  • Bug fixes and improvements

v0.7.2 (Apr 19) ​

  • Fixed Docker UDP port forwarding for reply packets
  • Don't change shell profile if PATH is already set correctly

v0.7.0, v0.7.1 (Apr 17) ​

  • Minor file sharing performance improvements for small files
  • 2-way localhost integration in Docker host networking mode
  • Faster Docker and machine shutdown
  • binfmt support for running macOS executables directly from Linux
  • Fixed load testing with many concurrent connections at once
  • Fixed Docker bind mounts in $TMPDIR
  • Fixed compatibility issues with ufw
  • Bug fixes and improvements

v0.7.1 is a stability hotfix for v0.7.0.

v0.6.2 (Apr 8) ​

  • Full support for eBPF tracing (bcc, bpftrace, etc.)
  • 20% faster startup
  • Slightly lower background CPU usage
  • Fixed custom Docker 20.10 instances with privileged containers

v0.6.1 (Apr 7) ​

  • Docker & Linux will now use the macOS certificate store
    • Includes self-signed CA certificates and Docker certs.d
  • Added support for disabling automatic proxy
  • Added support for Istio (Kubernetes service mesh)
  • Added syscall tracepoints and tracefs
  • Improved startup reliability
  • Fixed issues with localhost HTTP(S)_PROXY environment from macOS
  • Updates: Docker 23.0.3, Linux 6.1.23
  • Bug fixes and improvements

v0.6.0 (Apr 3) ​

  • Automatic HTTP/HTTPS/SOCKS proxy for Docker and Linux traffic
  • Added support for editing Docker engine config
  • Added support for limiting CPU usage
  • Added orb logs command to view Docker and machine logs
  • Fixed access to Docker volumes with strict permissions
  • Fixed host-gateway as extra host
  • Fixed unexpected shutdowns when using a proxy
  • Smoother uninstall flow
  • Updates: Linux 6.1.22
  • Bug fixes and improvements

v0.5.2 (Mar 29) ​

  • Fixed most "Failed to get machines" errors (complete fix in progress)
  • Docker: Fixed localhost issues with IPv4-only servers
  • Linux: Fixed passwordless sudo for usernames containing periods
  • Linux: Fixed missing macOS tools in PATH with some non-default shells
  • Removed lnx and lnxctl command aliases
  • Stricter permissions on ~/OrbStack
  • Updates: Docker 23.0.2
  • Bug fixes and improvements

Interim release with lots of small bug fixes. More work to improve GUI reliability and usability is in progress.

v0.5.1 (Mar 26) ​

πŸš€ Announcing public beta!

  • More reliable machine creation and management
  • Breaking change: Moved SSH server to port 32222 to avoid conflicts
  • Docker Desktop CLI tools will now be replaced during setup
  • Added support for keeping Docker disabled
  • Better behavior when there's no network connection
  • Fixed setup with some shells and Active Directory environments
  • Updates: Linux 6.1.21, Docker Compose 2.17.2
  • Bug fixes and improvements

v0.5.0 (Mar 20) ​

  • Full-blown Docker GUI
  • Breaking change: Moved Docker & Linux mounts to ~/OrbStack for clarity
  • Added support for Cilium and eBPF development
  • Added support for systemd user services
  • Added 32-bit x86 emulation on Apple Silicon
  • Starting Linux shells is now significantly faster
  • Updated to Linux 6.1.20
  • Bug fixes

v0.4.0 (Mar 15) ​

  • All-new comprehensive documentation, hot off the press
  • Added docker.internal for connecting to Docker from Linux machines
  • Finished dynamic disk size implementation (now reflected in df)
  • Changed IPv6 subnet to better comply with RFC
  • Improved uninstall flow
  • Updated to Linux 6.1.19
  • Added support for AF_XDP sockets
  • UI tweaks
  • Bug fixes

v0.3.1 (Mar 9) ​

  • Added examples for getting started with Docker
  • Added slower fallback for Rosetta on macOS 12
  • Fixed empty window when re-opening app with collapsed sidebar
  • Fixed Docker bind mounts under /tmp
  • Fixed WebAssembly segfaults on 2020 Intel Macs
  • Other bug fixes

v0.3.0 (Mar 5) ​

  • Major stability and reliability improvements
  • Linux and Docker data now appears under β€œOrbStack” in Finder
  • Significantly faster networking in Docker containers
  • Updated to Linux 6.1.15
  • Added restart command
  • Fixed occasional "VM did not start" errors on first launch
  • Other bug fixes and improvements

v0.2.1 (Feb 28) ​

  • Fixed machine creation with RHEL-based distros
  • Fixed command-line tool setup with iTerm shell integration
  • Workaround for rare errors on initial launch
  • Reorganized app menus
  • Other bug fixes

v0.2.0 (Feb 27) ​

  • Added support for NixOS machines
  • Fixed /Users/<user>/OrbStack access from within Linux machines
  • Fixed Docker potentially not starting again after disabling it in the app
  • Fixed potential issues with custom Docker instances in Linux machines
  • Faster machine creation for some distros
  • Other bug fixes

v0.1.9 (Feb 25) ​

  • Many stability improvements and bug fixes
  • Added host.docker.internal and other domains for compatibility with Docker Desktop
  • Added compatibility with Docker Desktop’s SSH agent forwarding
  • Workaround for macOS bug: β€œ(null) is not allowed to open documents in Terminal”
  • Fixed mDNS and .local domains in distros that use systemd-resolved

v0.1.8 (Feb 23) ​

  • Added Docker buildx for extra BuildKit features
  • Added support for IPv6 in Docker containers
  • Added release notes
  • Updated to Linux 6.1.13
  • New settings UI
  • Fixed compatibility issues with Earthly
  • Fixed SSH access with read-only SSH configs
  • Other bug fixes

v0.1.7 (Feb 22) ​

OrbStack is now fully built with itself, including the Linux parts! πŸŽ‰

  • Added support for mounting VM disk images
  • Improved SSH key handling when no agent is in use
  • Fixed config permissions in new machines
  • Other bug fixes

v0.1.6 (Feb 21) ​

  • Improved appearance of notifications sent from Linux
  • Added support for command-line tool setup without UI
  • Fixed notifications on macOS 12
  • Fixed handling of large ICMP packets
  • Other bug fixes