🛠️ Accessing Your RuneLite Client Logs
Knowing how to access your RuneLite client logs is important because debugging issues with plugins or the client often requires these files. Staff members, such as Admins or Developers, will frequently ask for you to provide the logs when troubleshooting client or plugin problems.
Kraken writes two log files:
| Log | Location | When to send it |
|---|---|---|
| RuneLite client log | ~/.runelite/logs/client.log | Plugins not loading, sign in problems, anything that happens in game |
| Kraken launcher log | ~/.runelite/kraken/logs/launcher.log | RuneLite fails to start, the Kraken window never appears, proxy not applied |
The launcher log rotates at 5 MB and keeps three older copies (launcher.1.log to launcher.3.log).
💻 Windows OS Instructions
Follow these steps to locate your RuneLite log files on Windows:
- Press the Win + R keys on your keyboard. This opens up the run editor to execute shortcuts to files on your computer.
- Copy & Paste the following path into the run field:
%userprofile%\.runelite\logs - Hit 'OK'. This action will load up your RuneLite logs folder.
- Please send the most recent
client.logorclientfile. This is the file that does not have a date in the file name.
For the launcher log, use %userprofile%\.runelite\kraken\logs instead and send launcher.log.
🍎 Mac OS Instructions
Follow these steps to locate your RuneLite log files on Mac:
- Open the Finder application.
- Press the following key combination: Shift + CMD + G (⇧ + ⌘ + G) to open the RuneLite logs folder
- Copy & paste the following path in the pop-up box:
~/.runelite/logs - Hit the Enter key. This action will load up your RuneLite logs folder.
- Please send the most recent
client.logorclientfile. This is the file that does not have a date in the file name.
For the launcher log, use ~/.runelite/kraken/logs instead and send launcher.log.
Extra Debug Output
Tick Debug Logs in the Kraken Plugins plugin configuration to add Kraken debug lines to client.log. Restart the client after enabling it.
Sharing Logs Automatically
The Kraken launcher has an opt-in Share Error Logs option (off by default). When it is on, and only when the client logs an error, the last 256 KB of client.log and launcher.log are compressed and sent to Kraken together with your Kraken client, API, RuneLite, Java and OS versions. Uploads happen at most once every 10 minutes and are linked to the Discord account you are signed in with, so support can find them when you open a ticket. Turn the option off again in the launcher window when you no longer need it.
⚠️ Security Warning: Do not send your client logs to unknown people, or post them in public chat channels; they may contain sensitive information.