---
name: "git-annex-remotedaemon"
section: "1"
platform: "linux"
package: "git-annex"
version: "10.20261026-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-annex-remotedaemon"
---

# git-annex-remotedaemon(1)

persistent communication with remotes

## NAME

git-annex-remotedaemon - persistent communication with remotes

## SYNOPSIS

git annex remotedaemon

## DESCRIPTION

The remotedaemon provides persistent communication with remotes.

Several types of remotes are supported:

For ssh remotes, the remotedaemon tries to maintain a connection to the remote git repository, and uses git-annex-shell notifychanges to detect when the remote git repository has changed, and fetches changes from it. For this to work, the git remote must have [git-annex-shell(1)](/git-annex-shell/1.md) installed, with notifychanges support. The first version of git-annex-shell that supports it is 5.20140405.

For tor-annex remotes, the remotedaemon runs a tor hidden service, accepting connections from other nodes and serving up the contents of the repository. This is only done if you first run **git annex enable-tor**. Use **git annex p2p** to configure access to tor-annex remotes.

For p2p-annex remotes, the remotedaemon runs a command **git-annex-p2p-\<netname\>** to get a socket file, listens to the socket file for connections from other peers, and serves up the contents of the repository. This is only done if you first run  **git-annex p2p --enable \<netname\>**.

Note that when **remote.\<name\>.annex-pull** is set to false, the remotedaemon will avoid fetching changes from that remote.

## OPTIONS

- **--foreground**

  -

  Don't fork to the background, and communicate on stdin/stdout using a simple textual protocol. The assistant runs the remotedaemon this way.

-

  Commands in the protocol include LOSTNET, which tells the remotedaemon that the network connection has been lost, and causes it to stop any TCP connctions. That can be followed by RESUME when the network connection comes back up.

-

  - Also the [git-annex-common-options(1)](/git-annex-common-options/1.md) can be used.

  ## SEE ALSO

[git-annex(1)](/git-annex/1.md)

[git-annex-assistant(1)](/git-annex-assistant/1.md)

[git-annex-enable-tor(1)](/git-annex-enable-tor/1.md)

[git-annex-p2p(1)](/git-annex-p2p/1.md)

## AUTHOR

Joey Hess \<id@joeyh.name\>