Quickstart (to get a demo up and running)ΒΆ

Converse.js has a CDN, provided by KeyCDN, which hosts its Javascript and CSS files.

The latest versions of these files are available at these URLs:

For a specific version of the files, you can put the version in the URL, as so:

You can include these two URLs inside the <head> element of your website via the script and link tags:

<link rel="stylesheet" type="text/css" media="screen" href="https://cdn.conversejs.org/css/converse.min.css">
<script src="https://cdn.conversejs.org/dist/converse.min.js"></script>

You need to initialize Converse.js with configuration settings according to your requirements.

Please refer to the Configuration variables section for info on all the available configuration settings.

To configure and initialize Converse.js, put the following inline Javascript code at the bottom of your page (after the closing </body> element).

require(['converse'], function (converse) {
        bosh_service_url: 'https://bind.conversejs.org', // Please use this connection manager only for testing purposes
        i18n: locales.en, // Refer to ./locale/locales.js to see which locales are supported
        show_controlbox_by_default: true,
        roster_groups: true

The index.html file inside the Converse.js repository may serve as a nice usable example.

These minified .js and .css files provide the same demo-like functionality as is available on the conversejs.org website. Useful for testing or demoing.

You’ll most likely want to implement some kind of persistent single-session solution for your website, where users authenticate once in your website and then stay logged in to their XMPP session upon the next page reload.

For more info on this, read: Single Session Support.

You might also want to have more fine-grained control of what gets included in the minified Javascript file. Read Creating builds for more info on how to do that.