How To: Edit Webmail Session Timeouts
=====================================

System administrators are able to manage webmail session timeouts at the CLI by
editing the Roundcube and Horde config templates. 

.. contents::

    
To Manage Session Timeouts in Roundcube
---------------------------------------

By default, Roundcube does not time out in the browser. However, session timeout
settings can be added. 

#. Log in to the server at the CLI as root, either via SSH or from the terminal
#. At the CLI, run the following to edit the Roundcube setting template--this will 
   prevent the changes from being overwritten upon update: 

   .. code-block::

      ~iworx/bin/config.pex --customize-template mail/roundcube-config.tpl --for-global

#. Add the following. This will define a session timeout in minutes:

   .. code-block::
 
      // In Minutes 
      $rcmail_config['session_lifetime'] = 10;

#. Save the file and exit the template editor 

To Manage Session Timeouts in Horde
-----------------------------------

In general, by default, Horde does not time out in the browser. The exception
to this is that, when creating a new email, if it is not sent, that url will 
time out after 30 minutes. 

#. Log in to the server at the CLI as root, either via SSH or from the terminal
#. At the CLI, run the following to edit the Horde setting template--this will 
   prevent the changes from being overwritten upon update: 

   .. code-block::

      ~iworx/bin/config.pex --customize-template mail/horde-config.tpl --for-global

#. To modify the general session timeout, edit the following (This setting is 
   0 by default, which indicates no overall session timeout):

   .. code-block::

      $conf['session']['timeout'] = 0;

#. To modify the url timeout (which relates to the page used to compose a new message),
   edit the following (this setting is in minutes):

   .. code-block::  

      //In Minutes
      $conf['urls']['token_lifetime'] = 30; $conf['urls']['hmac_lifetime'] = 30;

#. Save the file and exit the template editor