Configuration

## Change mailboxes path used in obm-opush
When you synchronize your mailboxes, Opush uses by default the folders : Inbox, Draft, Sent and Trash

If you want to use a special configuration you can change those values into the properties file /etc/opush/mail_conf.ini

Available keys are :
* imap.mailbox.draft
* imap.mailbox.sent
* imap.mailbox.trash

That is a sample where your emails will be put under a "myjob" folder :

imap.mailbox.draft=myjob/received
imap.mailbox.sent=myjob/sent
imap.mailbox.trash=myjob/bin

**Note :** The 'Inbox' folder can't be changed because it's a special case as defined into the IMAP rfc.

**To use special chars :**

You can use special chars into the configuration, but because the file is encoded in ISO 8859-1 you can't write them as they are.

A JDK tool named 'native2ascii' is able to translate special chars. To use it, do :

cp /etc/opush/mail_conf.ini /etc/opush/mail_conf.ini.save
nano /etc/opush/mail_conf.ini # Put your configuration here, with special chars
native2ascii /etc/opush/mail_conf.ini /etc/opush/mail_conf.ini.new
cp /etc/opush/mail_conf.ini.new /etc/opush/mail_conf.ini

***

## LDAP

### About LDAP in Opush
In Opush, LDAP is only used for some kind of user lookup depending of the client request.

#### When is LDAP used by Opush ?
It's often used for recipient auto-completion when the user writes an email.

#### When is LDAP NOT used by Opush ?
LDAP is not used by Opush to populate the client address books. To achieve this, Opush will ask obm-sync to retrieve the user's contacts.

### Configuration file
The Opush LDAP configuration file is located at _/etc/opush/ldap_conf.ini_

#### Fields
Every field is required and cannot be empty.

* **search.ldap.filter** : the filter expression to use for the search
* **search.ldap.url** : the address where the ldap server can be reached (we advise to specify the protocol used, _ldap://_ or _ldaps://_)
* **search.ldap.basedn** : the name of the context or object to search for

#### Sample

search.ldap.filter=(&(objectClass=inetOrgPerson) (|(mail=%q*)(sn=%q*)(givenName=%q*)))
search.ldap.url=ldap://127.0.0.1
search.ldap.basedn=dc=%d,dc=local

#### Log
You can check your LDAP configuration by looking at logs when Opush starts.
You only have to activate the _CONFIGURATION_ logger, for details check the [Logs documentation section](/wiki/logs).
Air Jordan I 1 Shoes