Fast setup
Save remotes once, test them from the UI, and stop copying long SSHFS commands into Terminal.
Native macOS mount manager
macFUSE GUI SSHFS
for macOS.
Stop rebuilding fragile mount commands. macFUSEGui gives macOS teams a focused macFUSE GUI for SSHFS, with per-remote controls, Keychain-backed credentials, diagnostics, and recovery after sleep or network changes.
Choose the right guide below, download the latest build, and keep Apple Silicon and Intel installs on a clean, repeatable path.
SW
MountManager.swift
1
func
refreshStatus(remote:
RemoteConfig)
async
{
2
// keep stale mounts calm before reconnecting the
remote
3
let
mountPoint
=
remote.
localMountPoint
4
let
responsive
=
try
await
isResponsiveMountPath(at:
mountPoint)
5
if
responsive
{
6
try
await
diagnostics.logDebug(
"mount",
"Responsive path confirmed for
\\(remote.displayName).")
7
}
8
let
dfRecord
=
try
await
currentMountRecordViaDF(at:
mountPoint)
9
if
let
dfRecord
{
10
return
.connected(dfRecord)
11
}
12
let
mountRecord
=
try
await
currentMountRecordViaMountTable(at:
mountPoint)
13
if
let
mountRecord
{
14
diagnostics.logDebug(
"mount",
"Recovered mount state via fallback
inspection.")
15
return
.connected(
mountRecord)
16
}
17
if
responsive
{
18
try
await
Task.
sleep(
nanoseconds: 250_000_000)
19
let
retryRecord
=
try
await
currentMountRecordViaDF(at:
mountPoint)
20
if
let
retryRecord
{
21
return
.connected(
retryRecord)
22
}
23
}
24
await
scheduleAutoReconnect(for:
remote.id,
reason:
.staleMount)
25
return
.disconnected
26
}
main
sshfs: connected
Swift
UTF-8
Finder-first SSHFS
Remote mounts without shell archaeology.
macFUSEGui keeps each remote visible, reconnectable, and diagnosable from the menu bar, so sleep, stale mounts, and hand-built SSHFS commands stop running the workflow.
- Per-remote connect and disconnect with clear live status.
- Keychain-backed credentials instead of copied secrets.
- Recovery after sleep, wake, network changes, and stale unmounts.
- Diagnostics you can copy before escalating a failed mount.
Choose the guide that matches your search intent
The site is organized around the exact problems people search for: understanding the product, comparing SSHFS GUI workflows, getting installed fast, and fixing failed mounts.
Guide map
macFUSE GUI for macOS
Understand how macFUSEGui fits above macFUSE and sshfs on macOS.
Guide map
SSHFS GUI for Mac
Compare a GUI-first SSHFS workflow on macOS with manual shell commands.
Guide map
Install macFUSE and SSHFS on Mac
Go from prerequisites to a working macFUSEGui mount on macOS.
Guide map
macFUSEGui Troubleshooting
Fix install, auth, mount-point, and recovery problems with macFUSEGui.
Why teams use macFUSEGui
The app sits above macFUSE and sshfs so remote folders behave like normal macOS directories in Finder, editors, and daily workflows.
Auto-reconnect
Desired remotes recover after sleep, wake, Wi-Fi changes, and external unmount events.
Keychain security
Passwords live in macOS Keychain while non-secret remote settings stay in JSON.
Per-remote control
Connect or disconnect one mount without blocking other active remotes.
Diagnostics
Copy environment checks, remote states, and recent logs before you start guessing.
Editor handoff
Mounted folders open cleanly in Finder and the app's editor-plugin flow.
Install and first-launch path
Install macFUSE and sshfs first, then pick the correct build for your CPU architecture and complete the one-time macOS approval flow.
Install methods
Homebrew Cask
Use the tap + cask path for repeatable installs and updates.
brew tap ripplethor/macfusegui https://github.com/ripplethor/macfuseGUI && brew install --cask ripplethor/macfusegui/macfuseguiTerminal Installer
Fetch the latest release installer and let the script choose the right artifact.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/ripplethor/macfuseGUI/main/scripts/install_release.sh)"Manual DMG
Download the correct DMG for your Mac and drag the app into Applications.
Prerequisites
macFUSEGui does not replace macFUSE or sshfs. It manages them. Install both before you expect a stable SSHFS mount on macOS.
If your setup already uses the Homebrew core formula, you can
also test
brew install sshfs
after macFUSE is installed.
brew install --cask macFUSE
brew install gromgit/fuse/sshfs-macChoose your download
Apple Silicon Macs use
arm64. Intel Macs use
x86_64. Confirm your
architecture first so you do not debug the wrong build.
On the release page, choose the DMG that ends with
-macos-arm64.dmg or
-macos-x86_64.dmg.
uname -mFirst-launch checklist
Step 1
Pick an install method
Use Homebrew, the one-line installer, or the direct DMG depending on how much automation you want.
Step 2
Open from Finder once
Right-click or Control-click the app and choose Open so macOS records the first-launch approval.
Step 3
Approve in Privacy & Security
If macOS blocks the app, use System Settings > Privacy & Security and choose Open Anyway.
How it works
macFUSEGui is the control plane. macFUSE provides the filesystem layer, sshfs handles the transport, and the app manages the workflow around both.
- Builds safe mount commands and manages connect, disconnect, and recovery.
- Keeps passwords in macOS Keychain instead of shell history.
-
Stores non-secret remote settings in
~/Library/Application Support/macfuseGui/remotes.json. - Surfaces diagnostics when installs, auth, or recovery behavior go wrong.
FAQ
Quick answers for setup, security, reliability, and the difference between a macFUSE GUI and raw SSHFS commands.