General Debugging
If you are having issues with AnythingLLM, the first thing you should do is check the logs. You can find the logs in the logs folder of your AnythingLLM storage - which you can find on your computer using this guide.
Why is the Desktop application unresponsive while AnythingLLM Docker is running?
AnythingLLM Desktop and the default AnythingLLM Docker setup both use port
3001 by default on your computer. Running both at the same time can sometimes cause a port
conflict that prevents the Desktop application from accepting text input or
opening its menu.
Stop the AnythingLLM Docker container before using the Desktop application. If you
need both running at the same time, map Docker to another available host port.
For example, change the port mapping in the
local Docker run command from
-p 3001:3001 to -p 3002:3001, then open the Docker instance at
http://localhost:3002.
AnythingLLM Debug mode on MacOS
To run the AnythingLLM Application in debug mode (if you are getting errors) you can open a Terminal and navigate to ~/Applications/AnythingLLM/Content/MacOs where you can then run the executable and see all application logs while running AnythingLLM.
AnythingLLM Debug mode on Windows
To run the AnythingLLM Application in debug mode (if you are getting errors) you can open a CMD or Powershell window and run the path to the AnythingLLM executable. Typically this is in C:\Users\usr\AppData\Local\Programs\anythingllm-desktop\AnythingLLMDesktop.exe.
This will print all logs to the powershell window while running and should display a verbose error once encountered that is critical for debugging.
AnythingLLM Debug mode on Linux
To run the AnythingLLM Application in debug mode (if you are getting errors) you can open a Terminal and navigate to ~/.config/anythingllm-desktop/AnythingLLMDesktop.AppImage where you can then run the executable and see all AppImage logs while running AnythingLLM.