Troubleshooting

Fast fixes for the most common FilesDesk issues.

What It Is

A checklist-style guide to diagnosing the handful of problems users actually hit — most have a one-click fix.

My subscription credits aren’t being used

Check Settings → the provider should be FilesDesk AI. Recent versions select it automatically on subscription activation; the header chip always shows the provider actually in use.

My own API key isn’t working

• Key pasted completely, under the correct provider.
• Key active (and funded) on the provider’s dashboard.
• BYOK requires the Lifetime license.

Local AI (Ollama) isn’t responding

• Ollama is running and a vision-capable model is downloaded.
• Changed Ollama’s port? Update it in FilesDesk Settings.

A watch folder isn’t picking up files

• The folder’s toggle is on (Automatic tab).
• Monitoring Filters aren’t excluding your files.
• Just-undone files are deliberately left alone briefly.
• Cloud folders: files must finish syncing before processing.

An Organize Flow didn’t move my file

• The flow is enabled, and the trigger matches (when a file appears vs. after AI renames).
• Conditions and the All/Any mode are right.
• Use the destination preview; prefer absolute paths like ~/Documents/Finance/{year}.

The Finder right-click action doesn’t appear (macOS)

• Launch FilesDesk once after installing.
• System Settings → Privacy & Security → Extensions → Finder: enable it.

A batch renamed files the wrong way

Open Processing History, find the entries, and undo. Original names come back exactly.

Still stuck?

Contact support via the website — real humans answer.

Related

• FAQ — Answers to the questions people ask most.
• Credits & Plans — Why credits might not be consumed.
• Contact Support — Contact support — real humans answer.

Last updated: 20 August 2026