FusionFS

Help

Installing FusionFS & FAQ

Everything you need to get mounted and synced, plus answers to the questions that come up most.

Installing on macOS

  1. 1

    Download FusionFS

    Sign in with GitHub, then grab the app from the Download page.

  2. 2

    Install macFUSE

    FusionFS mounts your project as a real folder on disk, which needs a filesystem extension to do — macFUSE is the standard open-source one for macOS. Get it from macfuse.github.io.

  3. 3

    Approve the extension

    macOS blocks any new kernel extension the first time, no exceptions. Open System Settings → Privacy & Security, find the blocked item from "Benjamin Fleischer" (macFUSE's signer), click Allow, and reboot if prompted. It's a one-time step.

  4. 4

    Open FusionFS and sign in

    Your projects show up ready to mount.

Installing on Linux

  1. 1

    Download the AppImage

    Sign in with GitHub, then grab it from the Download page.

  2. 2

    Make it executable

    chmod +x the file, or use your file manager's "Allow execution" option.

  3. 3

    Run it

    No extra install needed — FUSE is already how most desktop Linux distros work.

Windows isn't supported yet — it's on the roadmap.

Frequently asked questions

Why do I need to install macFUSE separately?

FusionFS mounts your project as an actual folder rather than a special app you open — that requires a filesystem extension, and macFUSE is the standard one for macOS. It's a one-time install, not something you'll need to touch again.

Is the "Allow" step in System Settings safe?

Yes — it's Apple's standard process for any kernel extension, not something specific to FusionFS. Apple requires the manual click precisely so an extension like this can never be approved silently, without you seeing it.

What platforms does FusionFS support?

macOS and Linux today, as a desktop app and an AppImage respectively. Windows isn't available yet.

What happens if I lose my internet connection?

Nothing stops working — edits keep saving to the Timeline locally, and FusionFS syncs automatically the moment you're back online. No manual step, no lost work.

Is my data private?

A .fusionignore file keeps build output, credentials, or anything else you mark local-only off the wire entirely — tracked on your machine, never sent anywhere.

Can two people edit the same file at once?

Yes. Concurrent changes from two people — or two of your own devices — reconcile automatically. There's no conflict marker to untangle by hand.