diff --git a/README.md b/README.md
index dcdda2c31611b3cd001b01cd55d76b78ca9a57f2..07f94059d9f99773d14aed13e5ec39ae513c5ec0 100644
--- a/README.md
+++ b/README.md
@@ -45,3 +45,13 @@ rake wiki:site_network       # Generate the media parts for site network pages
 ```
 
 For more information about generators and validators, please see generators/README.md.
+
+# Credentials
+
+all tools should use ~/.grid5000_api.yml. Example:
+```
+ uri: https://api.grid5000.fr/
+ username: username
+ password: password
+ version: stable
+```