diff --git a/docs/ssh-over-tor.md b/docs/ssh-over-tor.md
index 7b0ff65..bf00a82 100644
--- a/docs/ssh-over-tor.md
+++ b/docs/ssh-over-tor.md
@@ -102,3 +102,24 @@ The Tilde.Black ssh fingerprints are listed below. Please verify your connection
     2048 SHA256:607+v+LKU8JMu3IBZ5TybQoU/R8kKsamYvtbEnW/LwA [tilde.black]:2222 (RSA)
     256 SHA256:9WydxCE5fOFWfrOwZrJEKIm8OFhi+7vt5VsF7CGBDxg [tilde.black]:2222 (ECDSA)
     256 SHA256:kCUXtju61+hD0wLZ0lb6OisP2Qf2K7hwyxTSvz5VoFM [tilde.black]:2222 (ED25519)
+
+### Optional: Configure SSH to Handle .onion Addresses
+
+Adding the following lines to `~/.ssh/config` will allow `ssh(1)` to connect to
+onion addresses using the Tor daemon's SOCKS proxy:
+
+    Host *.onion
+        ProxyCommand /usr/bin/nc -xlocalhost:9050 -X5 %h %p
+
+Now that `ssh(1)` knows how to connect to onion addresses, a convenient shortcut
+can be added for tilde.black's onion address:
+
+    Host tilde.black.onion
+        HostName black6kfjetfuzaeozz7fs53whh7xtd4e27telrf5fg5kgdt5ah5plad.onion
+        Port 2222
+        <your-normal-configuration>
+
+With those two additions `ssh(1)` can connect to tilde.black's onion address
+though a much more memorable name:
+
+    ssh user@tilde.black.onion