README
author Kim Alvefur <zash@zash.se>
Sat, 23 Mar 2024 20:48:19 +0100
changeset 13465 c673ff1075bd
parent 12227 a68f1617721b
permissions -rw-r--r--
mod_posix: Move everything to util.startup This allows greater control over the order of events. Notably, the internal ordering between daemonization, initialization of libunbound and setup of signal handling is sensitive. libunbound starts a separate thread for processing DNS requests. If this thread is started before signal handling has been set up, it will not inherit the signal handlers and instead behave as it would have before signal handlers were set up, i.e. cause the whole process to immediately exit. libunbound is usually initialized on the first DNS request, usually triggered by an outgoing s2s connection attempt. If daemonization happens before signals have been set up, signals may not be processed at all.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1192
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     1
# Prosody IM Server
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     2
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     3
## Description
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     4
12227
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
     5
Prosody is a server for Jabber/XMPP written in Lua. It aims to be easy to use
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
     6
and light on resources. For developers, it aims to give a flexible system on
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
     7
which to rapidly develop added functionality or rapidly prototype new
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
     8
protocols.
1192
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     9
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    10
## Useful links
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    11
7362
a5a080c12c96 Update every link to the documentation to use HTTPS
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 2665
diff changeset
    12
Homepage:        https://prosody.im/
a5a080c12c96 Update every link to the documentation to use HTTPS
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 2665
diff changeset
    13
Download:        https://prosody.im/download
a5a080c12c96 Update every link to the documentation to use HTTPS
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 2665
diff changeset
    14
Documentation:   https://prosody.im/doc/
9949
606b2567ff18 README: Add link to current issue tracker
Kim Alvefur <zash@zash.se>
parents: 9948
diff changeset
    15
Issue tracker:   https://issues.prosody.im/
1192
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    16
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    17
Jabber/XMPP Chat:
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    18
               Address:
1391
b910ef82622d README: Update for new MUC address
Matthew Wild <mwild1@gmail.com>
parents: 1192
diff changeset
    19
                 prosody@conference.prosody.im
1192
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    20
               Web interface:
10696
a0480ee2233a README: Update link to web chat
Kim Alvefur <zash@zash.se>
parents: 9949
diff changeset
    21
                 https://chat.prosody.im/
12227
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
    22
1192
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    23
Mailing lists:
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    24
               User support and discussion:
7362
a5a080c12c96 Update every link to the documentation to use HTTPS
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 2665
diff changeset
    25
                 https://groups.google.com/group/prosody-users
12227
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
    26
1192
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    27
               Development discussion:
7362
a5a080c12c96 Update every link to the documentation to use HTTPS
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 2665
diff changeset
    28
                 https://groups.google.com/group/prosody-dev
12227
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
    29
1192
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    30
## Installation
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    31
12227
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
    32
See the accompanying INSTALL file for help on building Prosody from source.
a68f1617721b README: Reflow text to ~78 columns
Kim Alvefur <zash@zash.se>
parents: 10696
diff changeset
    33
Alternatively see our guide at https://prosody.im/doc/install
1192
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    34
b1b42ce4f0f6 Finally add README and INSTALL files
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    35