diff docs/setup.rst @ 8372:a9e71e61cedf stable

ssh: mention in docs how to use multiple authorized_keys files
author Mads Kiilerich <mads@kiilerich.com>
date Wed, 29 Apr 2020 15:00:59 +0200
parents f8f50d3b6512
children a67945aec3df b688a2a1b189
line wrap: on
line diff
--- a/docs/setup.rst	Wed Apr 22 20:47:02 2020 +0200
+++ b/docs/setup.rst	Wed Apr 29 15:00:59 2020 +0200
@@ -153,6 +153,16 @@
     process, the server process will raise an exception each time it attempts to
     write the ``authorized_keys`` file.
 
+.. note:: It is possible to configure the SSH server to look for authorized
+   keys in multiple files, for example reserving ``ssh/authorized_keys`` to be
+   used for normal SSH and with Kallithea using
+   ``.ssh/authorized_keys_kallithea``. In ``/etc/ssh/sshd_config`` set
+   ``AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys_kallithea``
+   and restart sshd, and in ``my.ini`` set ``ssh_authorized_keys =
+   /home/kallithea/.ssh/authorized_keys_kallithea``. Note that this new
+   location will apply to all system users, and that multiple entries for the
+   same SSH key will shadow each other.
+
 .. warning:: The handling of SSH access is steered directly by the command
     specified in the ``authorized_keys`` file. There is no interaction with the
     web UI.  Once SSH access is correctly configured and enabled, it will work