diff --git a/roles/forgejo_runners/README.md b/roles/forgejo_runners/README.md
index 9e1e927..33f9166 100644
--- a/roles/forgejo_runners/README.md
+++ b/roles/forgejo_runners/README.md
@@ -2,6 +2,17 @@
 
 Ansible role to manage [Forgejo](https://forgejo.org/) runners.
 
+## Configuration
+
+See [Variable
+precedence](https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_variables.html#ansible-variable-precedence)
+to find where you should put your own variables.
+
+Then define at least `forgejo_db_password` with a strong and secure password,
+encrypted using
+[ansible-vault](https://docs.ansible.com/ansible/latest/cli/ansible-vault.html).
+
+
 ## Table of Content
 
 <!-- ANSIBLE DOCSMITH TOC START -->