Diff

prosody.cfg.lua.dist @ 2694:a6d80b6e9ee1

prosody.cfg.lua.dist: Update config for 0.7, most improvements from the Arch Linux package by dbb, thanks!
author Matthew Wild <mwild1@gmail.com>
date Sun, 21 Feb 2010 17:33:13 +0000
parent 2408:550dd0014575
child 2716:4e4a24a1288d
line wrap: on
line diff
--- a/prosody.cfg.lua.dist	Sun Feb 21 16:57:06 2010 +0000
+++ b/prosody.cfg.lua.dist	Sun Feb 21 17:33:13 2010 +0000
@@ -1,5 +1,5 @@
 -- Prosody Example Configuration File
--- 
+--
 -- If it wasn't already obvious, -- starts a comment, and all
 -- text after it on a line is ignored by Prosody.
 --
@@ -17,76 +17,102 @@
 --
 -- ssl = { key = "keyfile.key", certificate = "certificate.cert" }
 --
--- Whitespace (that is tabs, spaces, line breaks) is mostly insignificant, so
+-- Whitespace (that is tabs, spaces, line breaks) is mostly
+-- insignificant, so
 -- can
--- be placed anywhere that 	you deem fitting.
+-- be placed anywhere 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
--- If there are any errors, it will let you know what and where they are, otherwise it
--- will keep quiet.
+-- Tip: You can check that the syntax of this file is correct when you
+-- have finished by running: luac -p prosody.cfg.lua
+-- If there are any errors, it will let you know what and where they
+-- are, otherwise it will keep quiet.
 --
--- The only thing left to do is rename this file to remove the .dist ending, and fill in the
+-- The only thing left to do is rename this file to remove the .dist
+-- ending, and fill in the
 -- blanks. Good luck, and happy Jabbering!
 
 -- Server-wide settings go in this section
 Host "*"
-	
-	-- This is a (by default, empty) list of accounts that are admins
-	-- for the server. Note that you must create the accounts separately
-	-- (see http://prosody.im/doc/creating_accounts for info)
-	-- Example: admins = { "user1@example.com", "user2@example.net" }
-	admins = { }
-	
-	-- 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 = {
-			-- Generally required
-				"roster"; -- Allow users to have a roster. Recommended ;)
-				"saslauth"; -- Authentication for clients and servers. Recommended if you want to log in.
-				"tls"; -- Add support for secure TLS on c2s/s2s connections
-				"dialback"; -- s2s dialback support
-			  	"disco"; -- Service discovery
-			
-			-- 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
-			  	"pep"; -- Enables users to publish their mood, activity, playing music and more
-				"register"; -- Allow users to register on this server using a client and change passwords
+
+    -- This is a (by default, empty) list of accounts that are admins for the
+    -- server. Note that you must create the accounts separately (see
+    -- http://prosody.im/doc/creating_accounts)
+    -- Example: admins = { "user1@example.com", "user2@example.net" }
+    admins = { }
+
+    -- Enable use of libevent for better performance under high load
+    -- For more information see: http://prosody.im/doc/libevent
+    --use_libevent = true;
+    
+    -- 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.
+    -- Documentation on modules can be found at: http://prosody.im/doc/modules
+    modules_enabled = {
+        -- Generally required
+        "roster";   -- Allow users to have a roster. Recommended ;)
+        "saslauth"; -- Authentication for clients and servers. Recommended if
+                    -- you want to log in.
+        "dialback"; -- s2s dialback support
+        "disco";    -- Service discovery
+        "posix";    -- POSIX functionality, daemonizes, enables syslog, etc.
+
+        -- Not essential, but recommended
+        "private";       -- Private XML storage (for room bookmarks, etc.)
+        "vcard";         -- Allow users to set vCards
+        "privacy";       -- Support privacy lists
+        "tls";           -- Support for secure TLS on c2s/s2s connections
+        --"compression"; -- Stream compression for client-to-server streams
 
-			-- Other specific functionality
-				--"posix"; -- POSIX functionality, sends server to background, enables syslog, etc.
-			  	--"console"; -- Opens admin telnet interface on localhost port 5582
-				--"bosh"; -- Enable BOSH clients, aka "Jabber over HTTP"
-				--"httpserver"; -- Serve static files from a directory over HTTP
-			  };
-	
-	-- These modules are auto-loaded, should you
-	-- for (for some mad reason) want to disable
-	-- them then uncomment them below
-	modules_disabled = {
-			-- "presence";
-			-- "message";
-			-- "iq";
-	};
+        -- 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
+        "pep";        -- Enables users to publish their mood, activity, playing
+                      -- music and more
+        "register";   -- Allow users to register on this server using a client
+                      -- and change passwords
+
+        -- Other specific functionality
+        --"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
+        --"groups";             -- Shared roster support
+        --"announce";           -- Send announcement to all online users
+        --"welcome";            -- Welcome users who register accounts
+        --"watchregistrations"; -- Alert admins of registrations
+    }
 
-	-- Disable account creation by default, for security
-	-- For more information see http://prosody.im/doc/creating_accounts
-	allow_registration = false;
-	
-	-- These are the SSL/TLS-related settings. If you don't want
-	-- to use SSL/TLS, you may comment or remove this
-	ssl = {
-		key = "certs/localhost.key";
-		certificate = "certs/localhost.cert";
-		}
+    -- These modules are auto-loaded, should you for (for some mad
+    -- reason) want to disable them then uncomment them below.
+    modules_disabled = {
+        --"presence";
+        --"message";
+        --"iq";
+    }
+
+    -- Disable account creation by default, for security
+    -- For more information see http://prosody.im/doc/creating_accounts
+    allow_registration = false;
+
+    --These are the SSL/TLS-related settings.
+    --ssl = {
+    --    key = "certs/localhost.key";
+    --    certificate = "certs/localhost.cert";
+    --}
+
+    -- Require encryption on client/server connections?
+    --c2s_require_encryption = false
+    --s2s_require_encryption = false
+
+    -- Logging configuration
+    -- For advanced logging see http://prosody.im/doc/logging
+    log = "prosody.log";
+    debug = false; -- Log debug messages?
 
 -- This allows clients to connect to localhost. No harm in it.
 Host "localhost"
@@ -94,17 +120,19 @@
 -- Section for example.com
 -- (replace example.com with your domain name)
 Host "example.com"
-
-	enabled = false -- This will disable the host, preserving the config, but denying connections
+    enabled = false -- This will disable the host, preserving the config, but
+                    -- denying connections (remove to enable!)
 
-	-- Assign this host a certificate for TLS, otherwise it would use the one
-	-- set in the global section (if any).
-	-- Note that old-style SSL on port 5223 only supports one certificate, and will always
-	-- use the global one.
-	ssl = {
-		key = "certs/example.com.key";
-		certificate = "certs/example.com.crt";
-		}
+    -- Assign this host a certificate for TLS, otherwise it would use the one
+    -- set in the global section (if any). Note that old-style SSL on port 5223
+    -- only supports one certificate, and will always use the global one.
+    --ssl = {
+    --    key = "certs/example.com.key";
+    --    certificate = "certs/example.com.crt";
+    --}
 
 -- Set up a MUC (multi-user chat) room server on conference.example.com:
-Component "conference.example.com" "muc"
+--Component "conference.example.com" "muc"
+
+-- Set up a SOCKS5 bytestream proxy for server-proxied file transfers:
+--Component "proxy.example.com "proxy65"