X-Git-Url: https://git.enpas.org/?a=blobdiff_plain;f=prosody.cfg.lua.dist;h=182f88893233acd01e45b1fe10dcc6dfce88fd06;hb=c0c83da1a045258025a2825f437af7a5e602c9c9;hp=52cc7c73604fa1bba96e4bfcb7a0c15dd912e9c9;hpb=0d91c5b851e45095533c17283e0d006d4924595c;p=prosody.git

diff --git a/prosody.cfg.lua.dist b/prosody.cfg.lua.dist
index 52cc7c73..182f8889 100644
--- a/prosody.cfg.lua.dist
+++ b/prosody.cfg.lua.dist
@@ -1,7 +1,7 @@
 -- Prosody Example Configuration File 
 -- 
 -- If it wasn't already obvious, -- starts a comment, and all 
--- text after it is ignored by Prosody.
+-- text after it on a line is ignored by Prosody.
 --
 -- The config is split into sections, a global section, and one 
 -- for each defined host that we serve. You can add as many host 
@@ -15,12 +15,12 @@
 -- A table is a list of values, except each value has a name. An 
 -- example would be:
 --
--- logging = { type = "html", directory = "/var/logs", rotate = "daily" }
+-- ssl = { key = "keyfile.key", certificate = "certificate.cert" }
 --
--- Whitespace (that is tabs, spaces, line breaks) is insignificant, so can 
+-- Whitespace (that is tabs, spaces, line breaks) is mostly insignificant, so 
+-- can 
 -- be placed anywhere
--- that 	you deem fitting. Youcouldalsoremoveitentirely,butforobviousrea
---sonsIdon'trecommendit.
+-- that 	you deem fitting.
 --
 -- Tip: You can check that the syntax of this file is correct when you have finished
 -- by running: luac -p prosody.cfg.lua
@@ -36,20 +36,31 @@ Host "*"
 	-- This is the list of modules Prosody will load on startup.
 	-- It looks for mod_modulename.lua in the plugins folder, so make sure that exists too.
 	modules_enabled = {
-				"saslauth"; -- Authentication for clients and servers. Recommended if you want to log in.
-				"legacyauth"; -- Legacy authentication. Only used by some old clients and bots.
+			-- Generally required
 				"roster"; -- Allow users to have a roster. Recommended ;)
-				"register"; -- Allow users to register on this server using a client
+				"presence"; -- See and broadcast status changes to/from contacts
+				"saslauth"; -- Authentication for clients and servers. Recommended if you want to log in.
 				"tls"; -- Add support for secure TLS on c2s/s2s connections
-				"vcard"; -- Allow users to set vCards
-				"private"; -- Private XML storage (for room bookmarks, etc.)
-				"version"; -- Replies to server version requests
 				"dialback"; -- s2s dialback support
 			  	"disco"; -- Service discovery
-			  	"ping"; -- XMPP Ping
-			  	"time"; -- Let others know the time here
-			  	"uptime"; -- Uptime reporting
-			  	"console"; -- telnet to port 5528 (needs console_enabled = true)
+			
+			-- Not essential, but recommended
+				"private"; -- Private XML storage (for room bookmarks, etc.)
+				"vcard"; -- Allow users to set vCards
+			
+			-- Nice to have
+				"legacyauth"; -- Legacy authentication. Only used by some old clients and bots.
+				"version"; -- Replies to server version requests
+			  	"uptime"; -- Report how long server has been running
+			  	"time"; -- Let others know the time here on this server
+			  	"ping"; -- Replies to XMPP pings with pongs
+
+			-- Other specific functionality
+				--"register"; -- Allow users to register on this server using a client
+				--"posix"; -- POSIX functionality, sends server to background, enables syslog, etc.
+			  	--"console"; -- telnet to port 5582 (needs console_enabled = true)
+				--"bosh"; -- Enable BOSH clients, aka "Jabber over HTTP"
+				--"httpserver"; -- Serve static files from a directory over HTTP
 			  };
 	
 	-- These are the SSL/TLS-related settings. If you don't want
@@ -75,4 +86,6 @@ Host "example.com"
 		}
 
 	enabled = false -- This will disable the host, preserving the config, but denying connections
-	
+
+-- Set up a MUC (multi-user chat) room server on conference.example.com:
+Component "conference.example.com" "muc"