Troubleshooting

What to do when a folder stays empty, a search misses a file's text, a server or a cloud disconnects or freezes, or rclone refuses to connect.

Website and App Store versions

The Mac App Store edition is coming soon. The website edition has everything. Compare the editions

On this page

Most problems come from a permission macOS has not given, a service that answers slowly, or an older version. Here is what to check first. If nothing helps, contact support with the steps that lead to the problem.

A folder stays empty, or a feature does nothing

macOS protects your folders and apps, and some features need your consent.

  1. Open Folia Files › Permissions… (or click Fix Permissions in the banner at the top of the window, when one is missing). Each row says what the permission is for, what doesn't work without it, and has its button (Allow…).
  2. Give the missing permission in System Settings, then come back: the state updates by itself.

Turned on in System Settings, but still refused? Another copy of Folia Files on your Mac (an older version, a copy in Downloads, a TestFlight build) may hold the permission: in System Settings, select Folia Files, remove it with −, then click Allow… again. See Permissions.

A search doesn't find a file's text

Searches In the text ask Spotlight for the text of documents. When a file is missing:

  • It's only in iCloud (not downloaded): Spotlight doesn't know its text. It is found by its name; download it, and it is found by its text too.
  • It's on your Desktop, in Documents, Downloads or iCloud Drive, and the search says Spotlight doesn't show these folders to Folia Files: give Folia Files Full Disk Access (the Full Disk Access… button under the results), then quit and reopen it. See Spotlight and Full Disk Access.
  • Spotlight doesn't index the place (a disk, or a folder excluded in System Settings › Spotlight): tick that place in the search's first pill (Where to search), and Folia Files reads its documents itself. Or tick Read every document, without Spotlight in the search's filter.
  • Your Mac's disk is almost full: Spotlight stops adding new files to its index. Free some space.

The ⓘ next to the search lists what it could not reach; Copy search report puts a report for us on the clipboard, without file names or the words you searched. See Search limits and the search report.

A file missing by its name? It may be hidden, a system file or inside an app's package: tick it under Also Include in the filter.

A server or a cloud disconnects

  1. Right-click the connection in the sidebar › Connection Log: it says when the mount appeared and disappeared, the slow checks, the reconnections, and rclone's own lines. See The connection log.
  2. When a server stays silent too long (30 seconds for a server, 2 minutes for a cloud), macOS removes the mount itself. Folia Files mounts it again, quietly, and says « Reconnected to “…” ».
  3. In the website version, after sleep or a network change, connections set to mount automatically come back on their own, and a share mounted elsewhere can get the same care: right-click it › Keep Connected (Reconnect Automatically). See Mounting and staying connected.

If it keeps dropping, turn on Detailed rclone log in the connection's log, mount again, and send us the log (Copy Log) after the next drop.

A server stops answering

Folia Files never waits for a server on its main window: when a server freezes, the window stays responsive, and what Folia Files needs from that server is read in the background.

  • Copies to or from it wait, in Operations.
  • Unmount the connection (right-click it in the sidebar), then Mount again once the server is back.
  • Quitting Folia Files never waits for a frozen mount either.

If the same server is frozen in the Finder too, check your network, your VPN, or the server itself. A mount that stays stuck after everything is closed is cleared by restarting the Mac.

rclone and cloud connections

  • Website version: rclone comes inside Folia Files; you don't need to install it, and Folia Files never uses another copy (Homebrew's, for instance). Your own rclone remotes stay usable as an Existing rclone Remote. See Clouds: the catalogue.
  • App Store version: there is no rclone, so no SFTP, S3 or cloud connections; your clouds show through their own Mac apps (more).
  • A cloud refuses to mount after a while: its sign-in may have expired. Open the connection (Tools › Connections (Servers and Clouds)… ⌘K) and click Sign In Again….
  • Google Drive is slow to mount the first time: a cloud gets 60 seconds. If it still fails, try again, or use Google's own app. See Google Drive.
  • An SFTP server refuses your key: when the key is protected by a passphrase, the connection's log tells you the command to type once in Terminal (see SFTP).

Test Connection, in the connection's editor, says what is wrong in plain words: login refused, port closed, server not answering, address not found.

The clipboard history sees nothing from other apps

Since macOS 15.4, macOS asks before an app reads what other apps copy. In System Settings › Privacy & Security › Paste from Other Apps, choose Allow for Folia Files, then relaunch Folia Files. See Clipboard history.

Folia Files stops responding

If the window stops responding for a few seconds, wait: a disk waking up or a slow service can hold it. Folia Files sends us a report of each freeze of 2 seconds or more when crash reports are on (see Privacy and crash reports), and these reports are how freezes get fixed. If it keeps happening, update, then tell us what you were doing.