Ansible Role RoundcubeMail

This guide helps you install and set up RoundcubeMail on your system.

GitHub	GitLab	Downloads	Version

Example Playbook

The example below is taken from molecule/default/converge.yml and is tested with every update.

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  vars_files:
    ../../vars/main.yml

  roles:
    - role: robertdebock.httpd
      httpd_vhosts:
        - name: docroot
          servername: localhost
          documentroot: "{{ roundcubemail_install_directory }}"
    - role: robertdebock.roundcubemail

Before running the playbook, you need to prepare the machine. In CI, this is done using molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: robertdebock.bootstrap
    - role: robertdebock.epel
    - role: robertdebock.buildtools
    - role: robertdebock.python_pip
    - role: robertdebock.openssl
      openssl_items:
        - name: apache-httpd
          common_name: "{{ ansible_fqdn }}"
    - role: robertdebock.selinux
    - role: robertdebock.httpd
    - role: robertdebock.php
      php_upload_max_filesize: 5M
      php_post_max_size: 6M
      php_date_timezone: Europe/Amsterdam
      php_extension:
        - mcrypt.so
    - role: robertdebock.mysql
      mysql_databases:
        - name: roundcube
      mysql_users:
        - name: roundcube
          password: roundcube
          priv: "roundcube.*:ALL"

For a full explanation and example of how to use these roles, check the link.

Role Variables

Default variable values are set in defaults/main.yml:

---
# defaults file for roundcubemail

roundcubemail_database_host: localhost
roundcubemail_database_user: roundcube
roundcubemail_database_password: roundcube
roundcubemail_database_name: roundcube

# A URL for support.
roundcubemail_support_url: "{{ ansible_fqdn }}/support"

# A key for encrypting sensitive data.
roundcubemail_des_key: 964af56991531a805bd55085

# The spellchecker to use: 'google', 'pspell', 'enchant', or 'atd'.
roundcubemail_spellcheck_engine: pspell

# The mail server used for login.
roundcubemail_default_host: localhost
roundcubemail_default_port: 143

# SMTP server settings for sending emails.
roundcubemail_smtp_server: localhost
roundcubemail_smtp_port: 25
roundcubemail_smtp_user: ""
roundcubemail_smtp_pass: ""

Requirements

• Install the Python packages listed in requirements.txt.

Used Roles

The following roles will prepare your system, though you can use other methods as well.

Requirement	GitHub	GitLab
robertdebock.bootstrap
robertdebock.buildtools
robertdebock.epel
robertdebock.httpd
robertdebock.mysql
robertdebock.openssl
robertdebock.php
robertdebock.python_pip
robertdebock.reboot
robertdebock.selinux

Context

This role works alongside many other roles. For more information, refer to the documentation of these roles.

Here's a look at the related roles:

Compatibility

This role has been tested with these Docker images:

You need Ansible version 2.12 or higher. Tests have been done for:

• The last version.
• The current version.
• The development version.

If you find any problems, please report them on GitHub.

License

This role is licensed under Apache-2.0.

Author Information

Created by robertdebock.

Consider sponsoring me.