> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS

> Set up FUSE on macOS for MIRAGE.

## Install macFUSE

```bash theme={null}
brew install --cask macfuse
```

## Enable Kernel Extension

<Steps>
  <Step title="Allow the Extension">
    Open **System Settings - Privacy & Security**. Scroll to the bottom, you will see:

    > "System software from developer 'Benjamin Fleischer' was blocked from loading."

    Click **Allow**.
  </Step>

  <Step title="Restart">
    Restart your Mac. macOS requires a reboot to load the kernel extension.
  </Step>

  <Step title="Verify">
    ```bash theme={null}
    ls /Library/Filesystems/macfuse.fs
    ```

    If this directory exists, macFUSE is installed.
  </Step>
</Steps>

## Apple Silicon (M1/M2/M3/M4)

If you don't see the **Allow** button:

<Steps>
  <Step title="Shut Down">
    Shut down your Mac completely.
  </Step>

  <Step title="Enter Recovery Mode">
    Hold the power button until "Loading startup options" appears. Click **Options - Continue**.
  </Step>

  <Step title="Enable Kernel Extensions">
    In Recovery: **Utilities - Startup Security Utility**. Set to **Reduced Security** and check **"Allow user management of kernel extensions"**.
  </Step>

  <Step title="Restart">
    Restart, then go back to **System Settings - Privacy & Security** to allow the extension.
  </Step>
</Steps>