The following are commonly requested options which can be configured in the file local.config.php located in the config directory.

For a full list of available configuration keys, please see the developer documentation page on configuration settings.

Password settings

You can change the requirements for user passwords in the config file. Options include minimum length, number of upper and lowercase letters, and setting allowed symbols.

'min_length' => 6,
        'min_lowercase' => null,
        'min_uppercase' => null,
        'min_number' => null,
        'min_symbol' => null,
        'symbol_list' => '`~!@#$%^&*()-=_+[]\{}|;:",./<>?\'',

Requirements will display on the user creation and edit pages.


  • thumbnails

    • Set the maximum dimensions for derivative images for media files.
    • Options for large, medium, and square. Defaults for these are 800, 200, and 200 respectively (all sizes are pixels)
  • thumbnailer_options

    • Default is Omeka\File\Thumbnailer\ImageMagick.
    • Also available are Omeka\File\Thumbnailer\Imagick and Omeka\File\Thumbnailer\Gd
    • You can also set the thumbnailer to NoThumbnail, which will prevent your Omeka S installation from generating thumbnails.

PHP Path

  • phpcli_path
    • Set the path the the php version you want to use.
    • Default is to attempt to detect correct path to PHP. Use this option to specify a path if needed in your server configuration. For example:
    'cli' => array(
        'phpcli_path' => '/usr/bin/php72',


  • mail
  • Default is to use Sendmail (this is set up in application/config/module.config.php)
  • If using SMTP use this example configuration, added to the end of local.config.php (see the zend-mail docs for clarification):
    'mail' => [
        'transport' => [
            'type' => 'smtp',
            'options' => [
                'name' => 'localhost',
                'host' => '',
                'port' => 25, // 465 for 'ssl', and 587 for 'tls'
                'connection_class' => 'smtp', // 'plain', 'login', or 'crammd5'
                'connection_config' => [
                    'username' => null,
                    'password' => null,
                    'ssl' => null, // 'ssl' or 'tls'
                    'use_complete_quit' => true,