# Installing Fabric Agent on macOS (Apple Silicon)

Installation guide for Macs with M1, M2, M3, or M4 chips

## Requirements

- macOS 12.0 (Monterey) or later
- Apple Silicon Mac (M1, M2, M3, or M4)
- 4GB RAM minimum (8GB+ recommended)
- Internet connection
- Fabric account (create one at fabric.carmel.so)

* * *

## Download

Log in to your dashboard at fabric.carmel.so

Go to the Devices section

Click "Download for macOS"

The correct version for your Mac is downloaded automatically

* * *

## Installation

**Open the DMG:** Double-click the downloaded file

**Drag to Applications:** Drag `FabricAgent.app` to your Applications folder

**Eject the DMG:** Right-click and eject, or drag to trash

**Launch:** Open FabricAgent from your Applications folder

**First Launch Security:**

If macOS shows a security warning:

- Go to System Preferences → Security & Privacy
- Click "Open Anyway" next to the FabricAgent message
- Or: Right-click the app → Open → Open

The app is signed and notarized by Apple, so this prompt should not appear for most users.

* * *

## First Run Setup

**Account:** Sign in with your Fabric account (Google OAuth or email/password)

**Daemon Installation:** The app installs a background daemon on first run

**Enroll Your Device:** Click "Enroll Node" to register your Mac with the network

Your hardware is automatically detected and your device is ready to start earning.

* * *

## Verifying Installation

After installation, verify everything is working:

**Check UI:** Open FabricAgent from Applications. You should see the dashboard.

**Check Status:** Your node status should show "Online" (green)

* * *

## Troubleshooting

**Daemon not starting:**

- Open the FabricAgent app
- It will automatically reinstall the daemon if missing

**Node shows Offline:**

- Check your internet connection
- Try unenrolling and re-enrolling your device

**App won't open:**

- Check macOS Security & Privacy settings
- Ensure you downloaded from the dashboard