mirror of
https://github.com/borgbackup/borg.git
synced 2026-05-28 04:03:21 -04:00
docs: add FAQ entry for SSH connection timeouts (fixes #5629)
This commit is contained in:
parent
7c8fa4e787
commit
d93f295082
1 changed files with 23 additions and 0 deletions
23
docs/faq.rst
23
docs/faq.rst
|
|
@ -146,6 +146,29 @@ How can I restore huge file(s) over an unstable connection?
|
|||
Try using ``borg mount`` and ``rsync`` (or a similar tool that supports
|
||||
resuming a partial file copy from what's already copied).
|
||||
|
||||
My SSH connection breaks during a long backup or prune operation. What now?
|
||||
---------------------------------------------------------------------------
|
||||
|
||||
Some ISPs or routers terminate idle SSH connections after a certain period of
|
||||
inactivity. This can happen during long-running Borg operations like ``create``
|
||||
(while chunking large files) or ``prune`` (while processing the repository),
|
||||
where Borg might be busy locally for a long time without sending or receiving
|
||||
data over the network.
|
||||
|
||||
To prevent this, you should configure your SSH client to send "keep-alive"
|
||||
packets periodically. Add the following to your ``~/.ssh/config`` (or to
|
||||
the ``BORG_RSH`` environment variable)::
|
||||
|
||||
Host *
|
||||
ServerAliveInterval 60
|
||||
ServerAliveCountMax 30
|
||||
|
||||
This configuration sends a packet every 60 seconds and allows up to 30 missed
|
||||
packets before closing the connection.
|
||||
|
||||
For more detailed information and alternative solutions, see the
|
||||
`BorgBase/Vorta FAQ <https://docs.borgbase.com/faq/#my-ssh-connection-breaks-after-a-long-backup-or-prune-operation>`_.
|
||||
|
||||
My machine goes to sleep causing `Broken pipe`
|
||||
----------------------------------------------
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue