Migration Manual

The macOS Escape Manual

Reclaiming your Hardware from the Walled Garden.

The Gilded Cage

Apple marketing has spent decades convincing creatives and developers that macOS is the only platform for serious work. They've built a "Gilded Cage": a beautiful interface, seamless integration, and high-quality hardware—all tied to a system that is increasingly hostile to user sovereignty. From the T2 chip to the mandatory iCloud login, macOS is no longer your OS; it is Apple's firmware for your life.

This manual provides the technical roadmap for "Escaping" macOS and moving to Tebian, with zero loss in productivity. We focus on Workflow Emulation and Virtualization.

1. Hardware Reclamation: Installing Tebian on Mac

Most Mac users don't realize their Intel or Apple Silicon hardware can run Linux faster and cooler than macOS. Tebian's support for Arm64 and x86_64 makes it the perfect replacement for any Mac from 2012 to 2026.

The T2 and M-Series Challenge

Apple uses custom silicon to lock down their machines. On Intel Macs with the T2 chip, Tebian includes the necessary kernel patches to handle the internal SSD and keyboard/trackpad out of the box. For Apple Silicon (M1/M2/M3), we leverage the Asahi Linux kernel patches, providing a native, GPU-accelerated Wayland experience on the world's most efficient hardware.

  • Retina Scaling: Tebian's HiDPI manual ensures your display is exactly as sharp as it was on macOS.
  • Trackpad Flow: We use libinput with custom curves to match the "feel" of the Mac trackpad, including multi-touch gestures.

2. The "macOS Apps on Linux" Question

The biggest hurdle to leaving macOS is the software. "How do I run Xcode?" "What about Photoshop?" Tebian's answer is **Architecture Isolation.**

The Xcode Solution (OSX-KVM)

You don't need macOS to be your host OS to build for iOS. Tebian's Virtualization Menu provides a one-click setup for OSX-KVM. This runs a full, hardware-accelerated version of macOS in a window on Tebian. You get native-speed access to Xcode, the App Store, and iCloud. You use macOS as a tool, not as a master.

The Creative Suite (Darling & Wine)

For standard Mac apps, we use Darling—a translation layer (like Wine, but for macOS binaries). While still maturing, Darling can run many CLI and simple GUI Mac tools natively on Tebian. For the Adobe suite, we recommend our Creative Bible workflow: using native Linux powerhouses like DaVinci Resolve, Bitwig, and Blender that out-render their Mac counterparts.

3. Workflow Sync: Spotlight to Fuzzel

The macOS "Spotlight" (Cmd+Space) is the soul of the Mac workflow. Tebian replaces this with Fuzzel. Our Fuzzel configuration is mapped to Super+D (or Cmd+Space if you prefer) and provides a faster, C-based search for apps, files, and system settings.

  • Stealth UI: Just like macOS, Tebian's "Ghost Mode" keeps the screen clean. No taskbars, no clutter.
  • T-Link Mesh: Replaces AirDrop and Handoff with a sovereign, WireGuard-based mesh that works on any hardware, not just Apple products.

Conclusion: The Sovereign Creative

The macOS Escape Manual is about moving from "Consumption" to "Production." You don't need Apple's permission to use your hardware. By moving to Tebian, you get the performance of Linux with the elegance of a Mac, and the freedom of a sovereign individual. One ISO. One menu. Total independence.