Prosody - Revision history

Johnno at 23:23, 14 December 2020

2020-12-14T23:23:45Z

Johnno at 10:58, 11 October 2017

2017-10-11T10:58:44Z

Johnno: /* Enabling sane multi-client support */

2015-12-15T01:02:27Z

Enabling sane multi-client support

Johnno: /* Enabling sane multi-client support */

2015-12-03T22:51:34Z

Enabling sane multi-client support

Johnno: /* Configure a virtual host for your domain */

2014-11-13T21:12:43Z

Configure a virtual host for your domain

Johnno at 21:10, 13 November 2014

2014-11-13T21:10:37Z

Johnno: /* Enabling sane multi-client support */

2014-11-13T12:22:45Z

Enabling sane multi-client support

Johnno at 11:55, 13 November 2014

2014-11-13T11:55:07Z

Johnno at 10:24, 13 November 2014

2014-11-13T10:24:55Z

Johnno at 10:24, 13 November 2014

2014-11-13T10:24:23Z

@@ Line 76: / Line 76: @@
   max_archive_query_results = 100;
-PostgreSQL and MySQL are also supprted. For SQL to work, you will need to install additional dependencies, for example:
+[[PostgreSQL]] and MySQL are also supported. For SQL to work, you will need to install additional dependencies, for example:
   apt install lua-dbi-sqlite lua-dbi-postgresql

@@ Line 1: / Line 1: @@
 __NOTOC__
-'''Prosody''' is a small and fast XMPP (jabber) server, written in Lua. You can use it in combination with [https://f-droid.org/repository/browse/?fdid=eu.siacs.conversations Conversations] for your [[Android]] phone, to provide your own federated instant messaging, and even host XMPP for multiple domains.
+'''Prosody''' is a small and fast XMPP (Jabber) server, written in Lua. You can use it in combination with [https://f-droid.org/repository/browse/?fdid=eu.siacs.conversations Conversations] for your [[Android]] phone, to provide your own federated instant messaging. It also hosts multiple XMPP virtual host domains.
 == Install ==
 On Ubuntu, you can install it like this:
@@ Line 8: / Line 10: @@
   sudo apt-get install prosody
-Edit the config <tt>/etc/prosody/prosody.cfg.lua</tt> to make sure you have BOSH support, group rosters and compression enabled, and you probably want self-registration off:
+Edit the config <tt>/etc/prosody/prosody.cfg.lua</tt> to make sure you have BOSH support, group rosters and compression enabled, you probably want self-registration off, and if you want persistent message history across all (compatible) devices (like Hangouts)<ref>Then don't use Pidgin; the developers appear to be asleep at the wheel, e.g. [https://developer.pidgin.im/ticket/15508 Ticket #15508 Support for XEP-0280]. That said, here's how to [[Pidgin|patch it]].</ref> you'll need to enable message archive management (MAM) as well:
   modules_enabled = {
     "compression";
     "bosh";
     "groups";
+  }
   allow_registration = false;
   ...
@@ Line 26: / Line 28: @@
 Set up a virtual host config for your domain in <tt>/etc/prosody/conf.avail/yourdomain.cfg.lua</tt>
-  VirtualHost "yourdomain.com"
+  VirtualHost "'''yourdomain.com'''"
       enabled = true
       ssl = {
-          key = "/etc/ssl/private/yourdomain.com.key";
+          key = "/etc/ssl/private/'''yourdomain.com'''.key";
-          certificate = "/etc/ssl/certs/yourdomain.com.crt";
+          certificate = "/etc/ssl/certs/'''yourdomain.com'''.crt";
           -- Ix nay on the SSL-ay (Heartbleed, Poodle, etc.)
           options = {"no_sslv2", "no_sslv3", "no_ticket", "no_compression",
@@ Line 37: / Line 39: @@
   -- optional, for IRC-style chatrooms
-  Component "chatrooms.yourdomain.com" "muc"
+  Component "conference.'''yourdomain.com'''" "muc"
       restrict_room_creation = "local"
   -- optional, for file transfers
-  Component "chatproxy.yourdomain.com" "proxy65"
+  Component "chatproxy.'''yourdomain.com'''" "proxy65"
 Then enable the config:
-  ln -s /etc/prosody/conf.avail/yourdomain.cfg /etc/prosody/conf.d/
+  ln -s /etc/prosody/conf.avail/'''yourdomain'''.cfg /etc/prosody/conf.d/
 == DNS configuration ==
-You need your chat, chatrooms, and chatproxy subdomains to be A records (not CNAME), and you also need 2 SRV records and a TXT record, thus:
+You need your chat, conference, and chatproxy subdomains to be A records (not CNAME), and you also need 4 SRV records and a TXT record, thus:
-  _xmpp-client._tcp.yourdomain.com    = SRV: 0 5 5222 chat.yourdomain.com
+ _jabber._tcp.'''yourdomain.com'''                  = SRV: 0 5 5269 chat.yourdomain.com
-  _xmpp-server._tcp.yourdomain.com    = SRV: 0 5 5269 chat.yourdomain.com
+  _xmpp-client._tcp.'''yourdomain.com'''             = SRV: 0 5 5222 chat.yourdomain.com
-  <nowiki>TXT: _xmpp-client-xbosh=https://chat.yourdomain.com/http-bind/ </nowiki>
+  TXT: _xmpp-client-xbosh=<nowiki>https://chat</nowiki>.'''yourdomain.com'''/http-bind/
 == Add some users ==
@@ Line 59: / Line 63: @@
 Add yourself with
-    sudo prosodyctl adduser yourusername@yourdomain.com
+    sudo prosodyctl adduser ''yourusername@yourdomain.com''
 == Enabling sane multi-client support ==
-Want persistent message history everywhere, like Hangouts?<ref>Then don't use Pidgin; the developers appear to be asleep at the wheel, e.g. [https://developer.pidgin.im/ticket/15508 Ticket #15508 Support for XEP-0280]. That said, here's how to [[Pidgin|patch it]].</ref> You'll need:
+Message archive management should really use a database:
   storage = {
       archive2 = "sql";  -- mam_archive requires SQL storage.
+  }
+  sql = { driver = "SQLite3", database = "prosody.db" }
   default_archive_policy = true;
   max_archive_query_results = 100;
 == Links ==

@@ Line 69: / Line 69: @@
 * [https://code.google.com/p/prosody-modules/wiki/mod_mam XEP-0313] Message Archive Management
-Luckily, these are all in the community contrib Mercurial repository, (which you can manage from [[git]]):
+Luckily, these are all in the community contrib Mercurial repository, which you can manage from [[git]]:
   git hg clone <nowiki>https://code.google.com/p/prosody-modules/ </nowiki>

@@ Line 69: / Line 69: @@
 * [https://code.google.com/p/prosody-modules/wiki/mod_mam XEP-0313] Message Archive Management
-Luckily, these are all in the community contrib repository:
+Luckily, these are all in the community contrib Mercurial repository, (which you can manage from [[git]]):
-  hg clone <nowiki>https://code.google.com/p/prosody-modules/ </nowiki>
+  git hg clone <nowiki>https://code.google.com/p/prosody-modules/ </nowiki>
 Then copy <tt>mod_smacks mod_mam* mod_carbons*</tt> into <tt>/usr/lib/prosody/modules</tt> on your server, and add this to your prosody configuration:

@@ Line 29: / Line 29: @@
       enabled = true
       ssl = {
-          key = "/etc/ssl/private/star.yourdomain.com.key";
+          key = "/etc/ssl/private/yourdomain.com.key";
-          certificate = "/etc/ssl/certs/star.yourdomain.com.crt";
+          certificate = "/etc/ssl/certs/yourdomain.com.crt";
           -- Ix nay on the SSL-ay (Heartbleed, Poodle, etc.)
           options = {"no_sslv2", "no_sslv3", "no_ticket", "no_compression",
@@ Line 43: / Line 43: @@
   Component "chatproxy.yourdomain.com" "proxy65"
-Then enable it with ln -s into <tt>/etc/prosody/conf.d</tt>
+Then enable the config:
 == DNS configuration ==

← Older revision		Revision as of 21:10, 13 November 2014
Line 21:		Line 21:

	...		...
		+
		+	== Configure a virtual host for your domain ==

	Set up a virtual host config for your domain in <tt>/etc/prosody/conf.avail/yourdomain.cfg.lua</tt>		Set up a virtual host config for your domain in <tt>/etc/prosody/conf.avail/yourdomain.cfg.lua</tt>

@@ Line 60: / Line 60: @@
 == Enabling sane multi-client support ==
-Want persistent message history everywhere, like Hangouts?<ref>Then don't use Pidgin; the developers appear to be asleep at the wheel, e.g. [https://developer.pidgin.im/ticket/15508 Ticket #15508 Support for XEP-0280: Message Carbons].</ref> You'll need:
+Want persistent message history everywhere, like Hangouts?<ref>Then don't use Pidgin; the developers appear to be asleep at the wheel, e.g. [https://developer.pidgin.im/ticket/15508 Ticket #15508 Support for XEP-0280]. That said, here's how to [[Pidgin|patch it]].</ref> You'll need:
 * [https://code.google.com/p/prosody-modules/wiki/mod_smacks XEP-0198] Stream Management