From 20fc1e6b0ce29f51b615fbbb76edbb3fc8fffe80 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Tue, 8 Mar 2022 18:23:44 +0530 Subject: [PATCH] Add a note about BSD servers --- docs/kittens/ssh.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/kittens/ssh.rst b/docs/kittens/ssh.rst index 497ae4ca4..9e1e2eebd 100644 --- a/docs/kittens/ssh.rst +++ b/docs/kittens/ssh.rst @@ -101,7 +101,7 @@ How it works ---------------- The ssh kitten works by having SSH transmit and execute a POSIX sh (or optionally -Python) script on the remote server using an :opt:`interpreter +Python) bootstrap script on the remote server using an :opt:`interpreter `. This script asks kitty for the setup data over the tty device, which kitty sends as a tarball. The script extracts it and places the :opt:`files ` and sets the :opt:`environment @@ -111,6 +111,13 @@ with a one-time random password that is generated when the script is transmitted that on the remote server, only the script can request data transmission over the TTY, any other requests are responded to by errors. +.. note:: + + When connecting to BSD servers, it is possible the bootstrap script will + fail or run slowly, because they are crippled in various ways. Your best bet + is to install python on the server and use :code:`python` as the + :opt:`interpreter kitten.ssh-interpreter>` in :file:`ssh.conf`. + .. include:: /generated/conf-kitten-ssh.rst