Search Our Database

Introduction

This article guides you through how to increase the maximum image upload size for signatures in Roundcube on a cPanel server via the command-line interface (CLI). By default, Roundcube limits the size of images that can be added to HTML signatures. Increasing this limit allows users to upload larger images for their email signatures or identities.

Pre-requisites

• Root or sudo access to your cPanel server.
• SSH access to the server.
• Basic familiarity with terminal commands and editing configuration files.

Steps to Increase the Maximum Image Upload Size

Step 1: Connect to Your Server via SSH

Use an SSH client (e.g., PuTTY or terminal) to log in:

ssh root@your.server.ip

Step 2: Edit the Roundcube Configuration File

Open the Roundcube configuration file with your preferred text editor (e.g., nano or vi):

nano /usr/local/cpanel/base/3rdparty/roundcube/config/config.inc.php

Step 3: Locate the Image Size Setting

Find the following lines (around line 567):

// Maximum size of uploaded image in kilobytes // Images (in html signatures) are stored in database as data URIs $config['identity_image_size'] = 64;

Step 4: Increase the Limit

Change the value from 64 (default, in KB) to your desired size limit. For example, to set it to 256 KB:

$config['identity_image_size'] = 256;

📌 Note: Values are in kilobytes (KB). Setting it too high may increase database size if many users upload large signature images.

Step 5: Save and Exit

If using nano:

CTRL + O # Save changes CTRL + X # Exit editor

If using vi or vim:

Press i # Enter Insert mode to edit Make your changes Press ESC # Exit Insert mode Type :wq and ENTER # Save and quit

Conclusion

By increasing the identity_image_size value in Roundcube’s configuration, you can allow larger images in email signatures, enhancing branding and visual appeal in outgoing emails.

If you require assistance or encounter any issues, please contact our support team at support@ipserverone.com.