--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_muc_ban_ip.wiki	Thu May 09 10:36:10 2013 +0000
@@ -0,0 +1,34 @@
+#summary Ban users from chatrooms by their IP address
+#labels Stage-Alpha
+
+= Introduction =
+
+One frequent complaint about XMPP chatrooms (MUCs) compared to IRC is the inability for a room admin to ban a user based on their IP address. This is because an XMPP user is not identified on the network by their IP address, only their JID.
+
+This means that it is possible to create a new account (often quite easy), and rejoin the room that you were banned from.
+
+This module allows the *user's* server to enforce IP-bans, which is very desirable for server admins who want to prevent their server being used for spamming and abusive behaviour.
+
+= Details =
+
+An important point to note is that this module enforces the IP ban on the banned user's server, not on the MUC server. This means that:
+
+  * The user's server MUST have this module loaded, however -
+  * The module works even when the MUC is on a different server to the user
+  * The module works for banning [http://prosody.im/doc/anonymous_logins anonymous users]
+
+Also note that IP bans are not saved permanently, and are reset upon a server restart.
+
+= Configuration =
+
+There is no extra configuration for this module except for loading it. Remember... do not load it on the MUC host, simply add it to your global `modules_enabled` list, or under a specific host like:
+
+{{{
+VirtualHost "anon.example.com"
+    authentication = "anonymous"
+    modules_enabled = { "muc_ban_ip" }
+}}}
+
+= Compatibility =
+|| 0.9 || Works ||
+|| 0.8 || Doesn't work ||
\ No newline at end of file