2013-03-24 13:09:41 +00:00
XMPP (Jabber) is used by the [[assistant]] as a git remote. This is,
technically not a git-annex special remote (large files are not transferred
over XMPP; only git commits are sent).
Typically XMPP will be set up using the web app, but here's how a manual
set up could be accomplished:
1. xmpp login credentials need to be stored in `.git/annex/creds/xmpp`.
Obviously this file should be mode 600. An example file:
XMPPCreds {xmppUsername = "joeyhess", xmppPassword = "xxxx", xmppHostname = "xmpp.l.google.com.", xmppPort = 5222, xmppJID = "joeyhess@gmail.com"}
2. A git remote is created using a special url, of the form `xmpp::user@host`
2013-03-24 13:10:48 +00:00
For the above example, it would be `url = xmpp::joeyhess@gmail.com`
2013-03-24 13:09:41 +00:00
3. The uuid of one of the other clients using XMPP should be configured
using the `annex.uuid` setting, the same as is set up for other remotes.
With the above configuration, the [[assistant]] will use xmpp remotes much as
any other git remote. Since XMPP requires a client that is continually running
to see incoming pushes, the XMPP remote cannot be used with git at the
command line.
2013-08-15 14:03:51 +00:00
## XMPP server support status
2013-08-15 08:28:02 +00:00
[[!table data="""
2013-08-15 11:41:37 +00:00
Provider|Status|Type|Notes
2013-08-15 16:02:59 +00:00
[[Gmail|http://gmail.com]]|Working|?|Google apps users will have to configure `.git/annex/creds/xmpp` manually
2013-08-15 11:41:37 +00:00
[[Coderollers|http://www.coderollers.com/xmpp-server/]]|Working|[[Openfire|http://www.igniterealtime.org/projects/openfire/]]
2013-08-15 14:03:51 +00:00
[[jabber.me|http://jabber.me/]]|Working|[[Tigase|http://www.tigase.org/]]
2013-08-15 16:02:59 +00:00
[[xmpp.ru.net|https://www.xmpp.ru.net]]|Working|[[jabberd2|http://jabberd2.org/]]
2013-08-15 17:28:59 +00:00
[[jabber.org|http://jabber.org]]|Working|[[Isode M-Link|http://www.isode.com/products/m-link.html]]
2013-08-15 16:02:59 +00:00
-|Working|[[Prosody|http://prosody.im/]]|No providers tested.
-|Working|[[Metronome|http://www.lightwitch.org/]]|No providers tested.
2013-08-15 14:03:51 +00:00
-|[[Failing|http://git-annex.branchable.com/forum/XMPP_authentication_failure/]]|ejabberd|[[Authentication bug|https://support.process-one.net/browse/EJAB-1632]]: Fixed in debian unstable with version 2.1.10-5
-|[[Failing|http://git-annex.branchable.com/forum/XMPP_authentication_failure/#comment-4ce5aeabd12ca3016290b3d8255f6ef1]]|jabberd14|No further information
2013-08-15 08:28:02 +00:00
"""]]
2013-08-15 14:03:51 +00:00
List of providers: [[http://xmpp.net/]]
2013-08-15 08:06:20 +00:00
2013-03-24 13:09:41 +00:00
See also: [[xmpp_protocol_design_notes|design/assistant/xmpp]]
