diff --git a/docs/services/semaphore.md b/docs/services/semaphore.md
index fde6c08..3ddd588 100644
--- a/docs/services/semaphore.md
+++ b/docs/services/semaphore.md
@@ -22,13 +22,18 @@ To enable this service, add the following configuration to your `vars.yml` file
 ########################################################################
 
 semaphore_enabled: true
+
 semaphore_hostname: semaphore.example.com
-semaphore_admin_password: STRONG_PASSWORD
-semaphore_admin_name: USERNAME
-semaphore_admin_email: user@example.org
+
+# Despite the confusing naming, semaphore_admin_name needs to hold a username, not a name!
+semaphore_admin_name: ''
+semaphore_admin_email: ''
+# You can generate a strong password with a command like: `pwgen -s 64 1`
+semaphore_admin_password: ''
+
 # Key for encrypting access keys in database.
 # It must be generated by using the following command: head -c32 /dev/urandom | base64
-semaphore_access_key_encryption: "PJOfV/7Q+ZDUxo2bgW8dgVbGJ6nNIJgEOyB3hcnVVz4="
+semaphore_access_key_encryption: ''
 
 ########################################################################
 #                                                                      #