Implements https://buddycloud.com/api
Build status of master branch
Build status of the develop branch
Install documentation is at https://buddycloud.org/wiki/Install
A websocket (using the xmpp-ftw interface can be found at $server/scripts/buddycloud.js. This exposes a global object called Buddycloud which you can instantiate to give you a websocket connection.
Please see buddycloud.com for more information on using this connection.
There is a docker image available for the API server. Configuration is currently passed via environment variables:
Configuration | Example | Description | Required or default |
---|---|---|---|
XMPP_DOMAIN | buddycloud.org | The XMPP domain for your server | ✓ |
XMPP_HOST | 192.168.0.55 | The hostname or IP of your XMPP server | ✓ |
CHANNEL_COMPONENT | channels.buddycloud.org | The channel server component address | ✓ |
ANONYMOUS_COMPONENT | anon.buddycloud.org | An 'anonymous' component which can be used for open nodes | null |
MEDIA_ENDPOINT | https://192.168.0.56:9000 | The endpoint for a media server | null |
PUSHER_COMPONENT | pusher.buddycloud.org | The location of a pusher component | null |
FRIENDFINDER_COMPONENT | finder.buddycloud.org | The location of a friend finder component | null |
SEARCH_COMPONENT | search.buddycloud.org | The location of a search component | null |
DISABLE_WEBSOCKET | 0 | Whether to disable the XMPP-FTW endpoint | false |
DEBUG | 1 | Whether to write additional debug to the logs | false |
Then simply launch the API server with the required environment variables as follows:
docker run -d -p 9123:9123 -e ..... buddycloud/api-server
Please log any issues at https://github.com/buddycloud/buddycloud-http-api/issues
For developing please see the config file named config.js.developer-example.
This code is Apache 2 licensed and copyright buddycloud.