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