Changes

Jump to navigation Jump to search
2,453 bytes added ,  13:28, 25 July 2023
m
no edit summary
Line 6: Line 6:  
=== Maintainer ===
 
=== Maintainer ===
 
[mailto:daniel@firewall-services.com[[User:VIP-ire|Daniel B.]]] from [http://www.firewall-services.com Firewall Services]
 
[mailto:daniel@firewall-services.com[[User:VIP-ire|Daniel B.]]] from [http://www.firewall-services.com Firewall Services]
 +
{{ #smeversion: smeserver-dovecot-extras }}
    
=== Description ===
 
=== Description ===
Line 14: Line 15:     
=== Requirements ===
 
=== Requirements ===
You need the [[Fws|firewall-services]] repo to install this contribs
+
Only available for sme9
   −
=== Installation 9.x Only===
+
===Installation===
This contrib is currently held in the [[fws]] repository, so the following commands will install on your smeserver.
+
<tabs container><tab name="For SME 10">
 
+
yum install --enablerepo=smecontribs smeserver-dovecot-extras
  yum install --enablerepo=fws smeserver-dovecot-extras
+
</tab><tab name="For SME 9">
 +
  yum install --enablerepo=smecontribs smeserver-dovecot-extras
    
You will then need to activate the database changes etc.
 
You will then need to activate the database changes etc.
Line 29: Line 31:     
  signal-event email-update
 
  signal-event email-update
 +
</tab>
 +
</tabs>
    
=== Configuration ===
 
=== Configuration ===
Line 39: Line 43:  
     access=private
 
     access=private
 
     status=enabled
 
     status=enabled
for example
+
for example if you want a SSL protected port
  config setprop sieve TCPORT 5190
+
  config setprop sieve TCPPort 5190
 
  signal-event email-update
 
  signal-event email-update
   Line 46: Line 50:  
you can change the IP listening (default localhost)
 
you can change the IP listening (default localhost)
 
  config setprop sieve Listen xxx.xxx.xxx.xxx
 
  config setprop sieve Listen xxx.xxx.xxx.xxx
 +
or
 +
config setprop sieve Listen "xxx.xxx.xxx.xxx yyy.yyy.yyy.yyy localhost"
 +
 
  signal-event email-update
 
  signal-event email-update
 +
 +
====Dovecot====
 +
Additional DB keys to configure dovecot (based on the original documentation [https://wikit.firewall-services.com/doku.php/smedev/dovecot here]):
 +
 +
* '''AdminIsMaster'''  (enabled|disabled, default is disabled): if enabled, the admin user will be a [http://wiki2.dovecot.org/Authentication/MasterUsers master user], and will be able to login as any user. To do so use ''user1'''*'''admin''  as login and the admin password to log in as user1. If you are using the [[Sogo]] groupware contrib this property has to be enabled.
 +
 +
* '''FullTextIndexing'''  (enabled|disabled, default is disabled): will turn on or off the full text indexing. When this option is enabled, a first search in an IMAP folder will trigger indexation. Next searches will be much faster. Read [http://wiki2.dovecot.org/Plugins/FTS/Squat this page] before enabling this option
 +
 +
* '''LogActions'''  (enabled|disabled, default is disabled): will turn on or off extra logging (flag change, move, copy etc…). **!! Warning !!**: enabling this can generate a huge amount of logs
 +
 +
* '''Quotas'''  (enabled|disabled, default is enabled): will report the actual used space and the remaining one if the user has a quota limit
 +
 +
* '''SharedMailbox'''  (enabled|disabled, default is disabled): will turn on or off shared mailbox and IMAP ACL support
 +
 +
After you've configured the prop like you want, for example by
 +
 +
config setprop dovecot AdminIsMaster enabled
 +
 +
run
 +
signal-event email-update
 +
to activate the changes to the configuration database.
    
* Sieve and dovecot-lda
 
* Sieve and dovecot-lda
Line 63: Line 91:  
====Shared Mailboxes====
 
====Shared Mailboxes====
   −
ShareMailbox is an important feature.
+
SharedMailbox is an important feature.
    
To enable it:
 
To enable it:
Line 80: Line 108:     
Once enabled, you can grant different access level (read, post, delete, change flags, create sub folders etc.) to other users, or group of users on your IMAP folders.
 
Once enabled, you can grant different access level (read, post, delete, change flags, create sub folders etc.) to other users, or group of users on your IMAP folders.
 +
 +
=== Backup and Restore ===
 +
The standard backup process should backup all your shared emails. If you have to restore the data to another server, you'll have to re-install the contrib. Once everything is restored, you'll have to turn off then back on the SharedMailbox feature, because permissions on shared emails uses extended ACL which are not backed up with most tools:
 +
db configuration setprop dovecot SharedMailbox disabled; signal-event email-update
 +
db configuration setprop dovecot SharedMailbox enabled; signal-event email-update
    
=== Uninstall ===
 
=== Uninstall ===
Line 85: Line 118:  
  signal-event post-upgrade;  signal-event reboot
 
  signal-event post-upgrade;  signal-event reboot
 
=== Bugs ===
 
=== Bugs ===
Sources for this contribs can be found in Firewall Service's repository [http://gitweb.firewall-services.com/?p=smeserver-dovecot-extras;a=summary]
+
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 +
and select the smeserver-php-scl component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-dovecot-extras|title=this link}}.
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-dovecot-extras|noresultsmessage="No open bugs found."}}
 
[[Category: Contrib]]
 
[[Category: Contrib]]
19

edits

Navigation menu