aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMatthew Wild <mwild1@gmail.com>2009-05-22 13:34:47 +0100
committerMatthew Wild <mwild1@gmail.com>2009-05-22 13:34:47 +0100
commit1bcc76adf76375b42d38a8ed28f04c3ae69addeb (patch)
tree84bf6fcdb2ef7a73cd70ef1db7060553665ae256
parentb724cfa46f130b243b7953f605c21af799f2ada9 (diff)
downloadprosody-1bcc76adf76375b42d38a8ed28f04c3ae69addeb.tar.gz
prosody-1bcc76adf76375b42d38a8ed28f04c3ae69addeb.zip
Finally add README and INSTALL files
-rw-r--r--INSTALL69
-rw-r--r--README37
2 files changed, 106 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 00000000..62cc8a6a
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,69 @@
+(This file was created from
+http://prosody.im/doc/installing_from_source on 2009-05-22)
+
+===== Building =====
+==== Dependencies ====
+There are a couple of libraries which Prosody needs installed before
+you can build it. These are:
+
+ * liblua5.1: Lua 5.1 library
+ * libssl 0.9.8: OpenSSL
+ * libidn11: GNU libidn library, version 1.1
+
+Both of these can be installed on Debian/Ubuntu with the packages:
+liblua5.1-dev libidn11-dev libssl-dev
+
+On other systems... good luck, but please let me know of the best way
+of getting the dependencies for your system and I can add it here.
+
+==== configure ====
+The first step of building is to run the configure script. This
+creates a file called 'config.unix' which is used by the next step to
+control aspects of the build process.
+
+All options to configure can be seen by running ./configure --help.
+Sometimes you won't need to pass any parameters to configure, but on
+most systems you shall.
+
+To make this a little easier, there are a few presets which configure
+accepts. You can load a preset using:
+
+ ./configure --ostype=PRESET
+
+Where PRESET can currently be one of: debian, macosx
+
+==== make ====
+Once you have run configure successfully, then you can simply run:
+
+ make
+
+Simple? :-)
+
+If you do happen to have problems at this stage, it is most likely
+due to the build process not finding the dependencies. Ensure you
+have them installed, and in the standard library paths for your
+system.
+
+For more help, just ask ;-)
+
+==== install ====
+At this stage you should be able to run Prosody simply with:
+
+ ./prosody
+
+There is no problem with this, it is actually the easiest way to do
+development, as it doesn't spread parts around your system, and you
+can keep multiple versions around in their own directories without
+conflict.
+
+Should you wish to install it system-wide however, simply run:
+
+ sudo make install
+
+...it will install into /usr/local/ by default. To change this you
+can pass to the initial ./configure using the 'prefix' option, or
+edit config.unix directly. If the new path doesn't require root
+permission to write to, you also won't need (or want) to use 'sudo'
+in front of the 'make install'.
+
+Have fun, and see you on Jabber!
diff --git a/README b/README
new file mode 100644
index 00000000..e45b89dd
--- /dev/null
+++ b/README
@@ -0,0 +1,37 @@
+# Prosody IM Server
+
+## Description
+
+Prosody is a server for Jabber/XMPP written in Lua. It aims to be easy
+to use and light on resources. For developers, it aims to give a
+flexible system on which to rapidly develop added functionality or
+rapidly prototype new protocols.
+
+## Useful links
+
+Homepage: http://prosody.im/
+Download: http://prosody.im/download
+Documentation: http://prosody.im/doc/
+
+Jabber/XMPP Chat:
+ Address:
+ prosody@conference.heavy-horse.co.uk
+ Web interface:
+ http://prosody.im/webchat
+
+Mailing lists:
+ User support and discussion:
+ http://groups.google.com/group/prosody-users
+
+ Development discussion:
+ http://groups.google.com/group/prosody-dev
+
+ Issue tracker changes:
+ http://groups.google.com/group/prosody-issues
+
+## Installation
+
+See the accompanying INSTALL file for help on building Prosody from source. Alternatively
+see our guide at http://prosody.im/install
+
+