= Chat: Pidgin / Prosody IM / Openfire Server =

== Downloads ==
  * [[https://prosody.im/download/|Prosody Server]]
  * [[http://www.igniterealtime.org/projects/openfire|Openfire Server]]
  * [[https://pidgin.im|Pidgin IM Client]]
  * [[http://audina.net/apps/sparkweb/SparkWeb.html|SparkWeb (web-based IM client)]]

== Openfire Administration ==
  * Visit [[http://OPENFIRE:9090]] - Login as ''admin''
  * When creating users, be sure to add them to the "All users" group.

=== Renewing Certificate ===
It may seem counterintuitive but in order to see the interface to automatically generate a self-signed certificate in Openfire you first must delete the old certificate. See the image below for an example of the interface you'll see after deleting the old certificate.
{{:systems:openfire-gen-self-sign-cert.png?nolink&600|}}
== Prosody Administration ==

=== Creating accounts ===
  # Use the Pidgin Account menu ad hoc server commands.
  # At the server console: <code>prosodyctl register <username> audina.net <password></code>
Note: Each account should also be added to the "All users" group in the group file at /etc/prosody/groups.txt

=== Removing accounts ===
To remove accounts, at the console type: <code>prosodyctl deluser <username>@audina.net</code>

=== Other Prosody information ===
To restart the service, at the console type: <code>prosodyctl restart</code>

User account information is stored in /var/lib/prosody/audina%2enet/accounts
== Client Software ==
  * Install Pidgin on client machine, or login to SparkWeb.
  * Configure IM client to point to Openfire server - openfire (Server20081).
  * Add the user/buddy ''all@broadcast.server20081'' with the alias "''All Broadcast''".

=== Pidgin Client ===
Add user account: Accounts > Manage Accounts (< ctrl > + A).
Enter the following settings:
  * Protocol: XMPP
  * Username: < username >
  * Domain: ''server20081''
  * Password: < password >
  * Local Alias: User's Full Name
{{ :systems:pidgin-client-account-setup.png?nolink |}}