Troubleshooting
Fixes for the most common issues people run into.
My subscription credits aren't being used
Open FilesDesk, go to Settings, and make sure FilesDesk AI is selected as your AI model. If a different provider is selected, FilesDesk will try to use that instead of your included credits.
My own API key isn't working
Double-check the key was pasted in full under the correct provider in Settings, and that the key is still active on your provider's dashboard. Remember BYOK requires the Lifetime license — subscriptions don't support custom keys.
Local AI (Ollama) isn't responding
Confirm Ollama is running and that you've downloaded a vision-capable model. FilesDesk needs to reach Ollama on its local address to send files for analysis — if you've changed Ollama's default port, update it in FilesDesk's Settings too.
A batch renamed files the wrong way
You don't need to fix it by hand. Open Processing History, find the batch, and undo it — this restores the original filenames.
Still stuck?
Reach out from the Contact page and we'll help you sort it out.