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