docs: keep up with changed reality.

ugly hack with relativ URLs because relref is apparently broken when linking to section pages (_index.md) except for a few cases...
2017-09-17 16:14:11 +02:00
parent 6a05e101cf
commit 3fd9726719
13 changed files with 332 additions and 133 deletions
@@ -0,0 +1,23 @@
+++
+title = "Transports"
+++
+
+{{% alert theme="warning" %}}Under Construction{{% /alert %}}
+
+## Stdinserver
+
+
+The SSH transport connects to the remote server using the SSH binary in
+`$PATH` and the parameters specified in the `zrepl` config file.
+
+However, instead of a traditional interactive SSH session, `zrepl` expects
+another instance of `zrepl` on the other side of the connection; You may be
+familiar with this concept from [git shell](https://git-scm.com/docs/git-shell)
+or [Borg Backup](https://borgbackup.readthedocs.io/en/stable/deployment.html).
+
+Check the examples for instructions on how to set this up on your machines!
+
+{{% panel %}}
+The environment variables of the underlying SSH process are cleared. `$SSH_AUTH_SOCK` will not be available. We suggest creating a separate, unencrypted SSH key.
+{{% / panel %}}
+