diff --git a/doc/reference/autoinstall-reference.rst b/doc/reference/autoinstall-reference.rst
index 2fcde9587..f87ff6539 100644
--- a/doc/reference/autoinstall-reference.rst
+++ b/doc/reference/autoinstall-reference.rst
@@ -736,6 +736,33 @@ allow-pw
 * **type:** boolean
 * **default:** ``true`` if ``authorized_keys`` is empty, ``false`` otherwise
 
+ssh examples:
+
+.. code-block:: yaml
+
+   autoinstall:
+     # default behavior
+     ssh:
+       install-server: false
+       authorized-keys: []
+       allow-pw: true
+
+   autoinstall:
+     # recommended configuration when openssh-server is desired
+     ssh:
+       install-server: true
+       authorized-keys:
+         # replace with the contents of the public key(s) as generated by
+         # ssh-keygen or similar tools
+         - ssh-ed25519 AAAAC3NzaC..6O8tvZobj user@host
+       allow-pw: false
+
+   autoinstall:
+     # configuration for password access
+     ssh:
+       install-server: true
+       allow-pw: true
+
 .. _ai-codecs:
 
 codecs