JMC user guide

Register a new account

To register an account, you have to go to "Service Discovery" in Psi or "Discover Services" in Gajim. Then you need to browse the JMC service:

You will then have the choice between IMAP, POP3 or SMTP accounts.

Register an IMAP account

When browsing the JMC service, select the IMAP line and click register:

You will then be presented a form to fill with connection settings:

• 'Account name' is a unique identifier for this account. It will be use to create a new contact in your Jabber roster: $ACCOUNT_NAME@jmc.yourserver.org . Do not use the name of an already existing JMC account.
• 'Action when *' is the action JMC should perform depending on your presence status :
  • 'Retrieve full email' will send complete emails as a Jabber messages. For HTML emails, only text will be send (without HTML nodes).
  • 'Retrieve digest' will send a single digest of all emails received since the last check.
  • 'Do nothing' do nothing :)
• 'Login' is the login used to connect to the IMAP server.
• 'Password' is the password used to connect to the IMAP server.
• 'Host' is the IMAP server hostname.
• 'Port' is the IMAP server port.
• 'Secure connection (SSL)' is to activate or not the secure connection through SSL to the IMAP server.
• 'Store password on Jabber server?': check this option if you want JMC to keep the password used to connect to the IMAP server. If unchecked, JMC will ask you the password everytime you login on your Jabber server as it will forget it when you logged off.
• 'Reports only emails received while connected to Jabber' is an option to get only emails received while you are connected to the Jabber server. JMC will not send emails received while you are logged off.
• 'Mail check interval' is the time (in minutes) between two checks for new emails (ie. JMC will check emails for this account every X minutes, X is the value of this option).
• 'Mailbox path' is the IMAP folder path to check. It usually is 'INBOX'. For subfolders, the separator between folders is usually '.' or '/' : 'INBOX.Happycoders' or 'INBOX/Happycoders'

Browse IMAP folder tree

As soon as you have a first IMAP account registered, you can add other folders of the same IMAP server by browsing the first registered account in 'Service Discovery':

You can then select register on any IMAP folder and the registration form will filled with the IMAP account setting you are browsing except the 'Account Name' parameter:

Register a POP3 account

To register a new POP3 account, follow the same procedure as registering an IMAP account. Only the 'Mailbox path' will not be present for a POP3 account:

Register a SMTP account

When registering a new SMTP account, the following form appears:

The first fifth field are the same as an IMAP account but for a SMTP server.

• 'Secure connection (TLS)' is to activate or not secure connection to the SMTP server through TLS.
• 'Your email address' is the 'From' field that will be used when sending an email with JMC.
  • It can be just your email: dax@happycoders.org
  • or you can add your name to it: David <dax@happycoders.org>
• 'Store password on Jabber server': check this option if you want JMC to keep the password used to connect to the IMAP server. If unchecked, JMC will ask you the password everytime you login on your Jabber server as it will forget it when you logged off.
• 'Default SMTP account': this account will be used when sending emails through JMC.

Update an account

To update an account, you have to browse JMC in 'Service Discovery' and you will find you accounts under the IMAP, POP3 or SMTP node depending on which type of account you want to update:

You can then register the account you want to update and a form filled with your account settings will appear:

All the options will be available except the account's name you cannot change.

To send emails

Get help by sending 'help' to one of your JMC contact.

Send a new email

Send a message to the JMC gateway (the default SMTP account will be used) or to one of the SMTP account in you roster. The subject of the email will be the subject of the Jabber message or the subject specified with the following syntax in the Jabber message body:

Subject: the subject

To specify email receivers, you need to add a line in the Jabber message body with the following syntax:

To: dax@happycoders.org

To: dax@happycoders.org, david.rousselie@happycoders.org

Reply to an email notified by JMC

Ad-hoc commands

Ad-hoc commands are available:

Fetch emails

You can choose emails that JMC can send you. In the email list, select the emails you want to receive through JMC (you can select multiple emails). Only ten emails are presented, to get the next ten, check 'select more emails to fetch' and click 'Finish'. When you have finished, uncheck 'select more emails to fetch' and click 'Finish'.

Force check for new emails

You can force JMC to check for new emails and do not wait for the next check. JMC will not check faster than every 1 minute.

Get last error

You can retrieve the last error JMC has reported for the selected account.

JMC admin guide

Ad-hoc commands

Admin users have more ad-hoc command to control JMC. These are available when executing a command on the gateway in your roster.

• Create new account
• Delete accounts
• Disable accounts
• Re-Enable accounts
• End users sessions
• Get user's password
• Changing user's password
• Get user's accounts
• Get user's last login time
• Get the number of registered accounts
• Get the number of disabled accounts
• Get the number of online accounts
• Get the list of registered accounts
• Get the list of disabled accounts
• Get the list of online accounts
• Make an annoucement
• Set the Message Of The Day
• Edit the Message Of The Day
• Delete the Message Of The Day
• Set Welcome Message
• Delete Welcome Message
• Edit the admin list
• Restart the service
• Shut down the service