* [XMPP Frontend](frontends/xmpp.html)

   * [Using SSL in server mode](configuration/server_ssl.html)

   * [Spectrum 2 as bouncer](configuration/bouncer.html)

* [Slack Frontend](frontends/slack.html)

#### Backends

* [Backends overview](backends/backends.html)

* [Libpurple backend](backends/libpurple.html)

* [Libcommuni backend](backends/libcommuni.html)

* [Twitter backend](backends/twitter.html)

* [Transwhat backend](backends/transwhat.html)

#### Tutorials

* [XMPP Frontend](frontends/xmpp.html)

   * [Spectrum 2 in gateway mode](tutorials/gateway_mode.html)

#### Configuration

* [Configuration file description](configuration/config_file.html)

* [MySQL Support](configuration/mysql.html)

* [PostgreSQL Support](configuration/postgresql.html)

* [Logging](configuration/logging.html)

#### Management

* [spectrum2_manager tool](management/spectrum2_manager.html)

* [Web Interface](management/web_interface.html)

* [Getting a backtrace](management/getting_backtrace.html)

* [Munin integration](management/munin.html)

#### Development

* [Spectrum 2 architecture](development/architecture.html)

* [Writing backend in any language (or How the backend works inside)](development/protocol.html)

	backend=/usr/bin/spectrum2_libcommuni_backend

LibCommuni backend can then work in two modes.

### One transport per one IRC network

This is preferred way if you know that you or your users will need to connect just one IRC network. It's also good mode of you maintain IRC server and want to provide XMPP access to it.

In this mode users can:

* connect the IRC network without joining the IRC channel.

* identify to NickServ (or any other service like that) using username and password from transport registration.

* have IRC contacts in their rosters. (Not done yet, but it's planned)

* see channel list in the service discovery. (Not done yet, but it's planned)

To use this mode, you have to configure irc_server variable like this:

	[service]

	irc_server=irc.freenode.org

### One transport for more IRC networks

In this mode users can connect more IRC networks, but they can't connect the network without being in the room. To connect the network, user has to join the room in following format: #room%irc.freenode.org@irc.domain.tld. The nickname used in the first join request is used as a nickname for the IRC connection.

###  All configuration variables

Key | Type | Default | Description

----|------|---------|------------

You have to choose this backend in Spectrum 2 configuration file to use it:

	[service]

	backend=/usr/bin/spectrum2_libpurple_backend

	protocol=prpl-jabber

As showed above, there is also special configuration variable in `[service]` section called `protocol` which decides which Libpurple's protocol will be used:

Protocol variable| Description

-----------------|------------

prpl-jabber| Jabber

prpl-aim|AIM

prpl-icq|ICQ

prpl-msn|MSN

prpl-yahoo|Yahoo

prpl-gg|Gadu Gadu

prpl-novell|Groupwise

### Third-party plugins

Spectrum 2 should work with any third-party libpurple plugin which is properly installed. For example, popular plugins:

Protocol variable| website | Description

-----------------|------------

These plugins are included by default in our Docker image.

### Support for Facebook stickers

Facebook stickers are supported using [Web Storage](../configuration/web_storage.html).

### Setting libpurple plugins configurations

Some libpurple protocol plugins allow setting configuration variables. Spectrum 2 passes every variable set in `purple` section to libpurple library. If you need to set such options, you can do it for example like this in your configuration file:

	[purple]

	clientlogin=1

	ssl=0

---

layout: page

title: Spectrum 2

---

### Web Storage

Web storage is used to send images and files received by Spectrum 2 to end user. When new image or file is downloaded from the 3rd-party network, it is stored into `service.web_directory` directory

and the link to that file, based on `service.web_url`, is sent to the user.

That means that you should configure the web-server on the machine where you run Spectrum 2 to serve `service.web_directory`.

If you for example use httpd, you can configure `service.web_directory=/var/www/html/spectrum2`. In that case, the matching `service.web_url` value will be `service.web_url=http://domain.tld/spectrum2`.