https://github.com/os-js/osjs-strophejs-application

OS.js Strophe.js XMPP Chat Application
https://github.com/os-js/osjs-strophejs-application

osjs osjs-application

Last synced: 11 months ago
JSON representation

OS.js Strophe.js XMPP Chat Application

• Host: GitHub
• URL: https://github.com/os-js/osjs-strophejs-application
• Owner: os-js
• License: other
• Created: 2018-07-11T17:08:04.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2022-08-09T22:53:04.000Z (almost 4 years ago)
• Last Synced: 2025-06-20T16:49:06.365Z (12 months ago)
• Topics: osjs, osjs-application
• Language: JavaScript
• Homepage: https://manual.os-js.org/v3/
• Size: 42 KB
• Stars: 2
• Watchers: 3
• Forks: 4
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          


  



[OS.js](https://www.os-js.org/) is an [open-source](https://raw.githubusercontent.com/os-js/OS.js/master/LICENSE) web desktop platform with a window manager, application APIs, GUI toolkit, filesystem abstractions and much more.

[![Support](https://img.shields.io/badge/patreon-support-orange.svg)](https://www.patreon.com/user?u=2978551&ty=h&u=2978551)

[![Support](https://img.shields.io/badge/opencollective-donate-red.svg)](https://opencollective.com/osjs)

[![Donate](https://img.shields.io/badge/liberapay-donate-yellowgreen.svg)](https://liberapay.com/os-js/)

[![Donate](https://img.shields.io/badge/paypal-donate-yellow.svg)](https://paypal.me/andersevenrud)

[![Community](https://img.shields.io/badge/join-community-green.svg)](https://community.os-js.org/)

# OS.js v3 Strophe.js Application

This is the Strophe.js XMPP Chat Application for OS.js v3

## Installation

```bash

npm install @osjs/strophejs-application

npm run package:discover

```

## Usage

This application connects to a standard XMPP server using BOSCH.

### Using external servers

Set up a [punjab](https://github.com/twonds/punjab) server and simply configure this application to connect to the BOSH endpoint.

```

Host: http://my-punjab-server/http-bind

Username: username@gmail.com

Password: abc123

```

### Custom BOSCH Server using Prosody

If you use Docker, you can simply add [Prosody](https://prosody.im/) to your docker-compose file:

> **NOTE: You have to copy the default prosody configuration into `src/etc/prosody` first. Then enable the BOSCH http server module.**

> NOTE: A domain name or hostname resolved via DNS is recommended (`my-domain.com` in this example)

```

services:

  prosody:

    image: prosody/prosody

    ports:

      - "5280:5280"

    volumes:

      - "./logs/prosody:/var/log/prosody"

      - "./src/prosody/etc:/etc/prosody"

```

You can now add users via the docker container with:

```

docker-compose exec prosody prosodyctl adduser username@my-domain.com

```

Then in the OS.js application:

```

Host: http://my-domain.com/http-bind

Username: username@my-domain.com

Password: abc123

```

## Contribution

* **Sponsor on [Github](https://github.com/sponsors/andersevenrud)**

* **Become a [Patreon](https://www.patreon.com/user?u=2978551&ty=h&u=2978551)**

* **Support on [Open Collective](https://opencollective.com/osjs)**

* [Contribution Guide](https://github.com/os-js/OS.js/blob/master/CONTRIBUTING.md)

## Documentation

See the [Official Manuals](https://manual.os-js.org/) for articles, tutorials and guides.

## Links

* [Official Chat](https://gitter.im/os-js/OS.js)

* [Community Forums and Announcements](https://community.os-js.org/)

* [Homepage](https://os-js.org/)

* [Twitter](https://twitter.com/osjsorg) ([author](https://twitter.com/andersevenrud))

* [Google+](https://plus.google.com/b/113399210633478618934/113399210633478618934)

* [Facebook](https://www.facebook.com/os.js.org)

* [Docker Hub](https://hub.docker.com/u/osjs/)