diff --git a/docs/aims2/aims2.md b/docs/aims2/aims2.md
index f6a0fec05dc5ad7467c94fe0253f8d59211ade94..351cab5d47a1b0b57403cee0d63b884e1704e9b7 100644
--- a/docs/aims2/aims2.md
+++ b/docs/aims2/aims2.md
@@ -48,6 +48,11 @@ All images are backed up into the DB as blobs, so they are not only stored in Ce
 * Owner: Alex Iribarren
 * Purpose: connecting to LANDB and LDAP
 
+**Password changing procedure:**
+* Annouce with an OTG that the service will be degraded for 5-10min. No new issued installations will work.
+* Update the service account password and update the Teigi stored value: `tbag set --hg aims aims_password --binary <new_password>`
+* Force a Puppet run on each of the AIMS hosts
+
 ---
 
 * User: `linux_private`