diff --git a/README.md b/README.md
index 007c8c1d..1f2c1269 100644
--- a/README.md
+++ b/README.md
@@ -248,6 +248,15 @@ Therefore, you should do these actions in the following scenarios
 
 - **Signed up with `email address`, generated `swarm.pem`, BUT lost `swarm.pem`** OR **You want to run multiple nodes at once**: run from scratch with the same email address and generate a new `swarm.pem`. 
 - **Signed up with `email address`, generated `swarm.pem`, kept `swarm.pem`** -> you can re-run a single node using this pair if you've still got them both.
+### Log file overview
+
+RL Swarm writes several log files to help you understand what is happening:
+
+- `logs/swarm.log` – high-level lifecycle events for your node and training loop.
+- `logs/prg_record.txt` – information about prediction markets and reward generation.
+- `logs/swarm_launcher.log` – details from the launcher script and environment checks.
+
+If something goes wrong, these files are usually the best first place to look before asking for help.
 
 ## Troubleshooting