{"id":17846453,"url":"https://github.com/technicalguru/docker-mailserver-roundcube","last_synced_at":"2025-10-19T05:49:09.421Z","repository":{"id":41839718,"uuid":"249237805","full_name":"technicalguru/docker-mailserver-roundcube","owner":"technicalguru","description":"Docker image for RoundCube in mailserver projects","archived":false,"fork":false,"pushed_at":"2025-02-11T08:42:57.000Z","size":6109,"stargazers_count":6,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-28T23:46:05.853Z","etag":null,"topics":["email","email-platform","postfix","postfix-docker","roundcube","roundcube-docker","roundcube-webmail","roundcubemail"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/technicalguru.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-22T17:38:38.000Z","updated_at":"2025-02-18T18:18:06.000Z","dependencies_parsed_at":"2023-01-19T16:15:39.392Z","dependency_job_id":"b8e1f352-05fa-40b6-aa0e-9f78ef887b91","html_url":"https://github.com/technicalguru/docker-mailserver-roundcube","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalguru%2Fdocker-mailserver-roundcube","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalguru%2Fdocker-mailserver-roundcube/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalguru%2Fdocker-mailserver-roundcube/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technicalguru%2Fdocker-mailserver-roundcube/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/technicalguru","download_url":"https://codeload.github.com/technicalguru/docker-mailserver-roundcube/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244059422,"owners_count":20391316,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email","email-platform","postfix","postfix-docker","roundcube","roundcube-docker","roundcube-webmail","roundcubemail"],"created_at":"2024-10-27T21:39:59.080Z","updated_at":"2025-10-19T05:49:09.415Z","avatar_url":"https://github.com/technicalguru.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# docker-mailserver-roundcube\nThis is a Docker image for Roundcube WebUI. The project is part of the \n[docker-mailserver](https://github.com/technicalguru/docker-mailserver) project but can run separately \nwithout the other components. However, a database server is always required to store data. \n\nRelated images:\n* [docker-mailserver](https://github.com/technicalguru/docker-mailserver) - The main project, containing composition instructions\n* [docker-mailserver-postfix](https://github.com/technicalguru/docker-mailserver-postfix) - Postfix/Dovecot image (mailserver component)\n* [docker-mailserver-opendkim](https://github.com/technicalguru/docker-mailserver-opendkim) - OpenDKIM image (DKIM signing milter component)\n* [docker-mailserver-postfixadmin](https://github.com/technicalguru/docker-mailserver-postfixadmin) - Image for PostfixAdmin (Web UI to manage mailboxes and domain in Postfix)\n* [docker-mailserver-amavis](https://github.com/technicalguru/docker-mailserver-amavis) - Amavis, ClamAV and SpamAssassin (provides spam and virus detection)\n\n# Tags\nThe following versions are available from DockerHub. The image tag matches the Roundcube version.\n\n* [1.6.11.0, 1.6.11, 1.6, 1, latest](https://hub.docker.com/repository/docker/technicalguru/mailserver-roundcube) - [Dockerfile](https://github.com/technicalguru/docker-mailserver-roundcube/blob/1.6.11.0/Dockerfile)\n* [1.5.2.0, 1.5.2, 1.5](https://hub.docker.com/repository/docker/technicalguru/mailserver-roundcube) - [Dockerfile](https://github.com/technicalguru/docker-mailserver-roundcube/blob/1.5.2.0/Dockerfile)\n* [1.4.11.0, 1.4.11, 1.4](https://hub.docker.com/repository/docker/technicalguru/mailserver-roundcube) - [Dockerfile](https://github.com/technicalguru/docker-mailserver-roundcube/blob/1.4.11.0/Dockerfile)\n\n# Features\n* Database and Roundcube setup from environment variables\n\n# License\n_docker-mailserver-roundcube_  is licensed under [GNU LGPL 3.0](LICENSE.md). As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).\n\nAs for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.\n\n# Prerequisites\nThe following components must be available at runtime:\n* [MySQL \u003e8.0](https://hub.docker.com/\\_/mysql) or [MariaDB \u003e10.4](https://hub.docker.com/\\_/mariadb) - used as database backend for domains and mailboxes. \n\n# Usage\n\n## Environment Variables\n_docker-mailserver-roundcube_  requires various environment variables to be set. The container startup will fail when the setup is incomplete.\n\n| **Variable** | **Description** | **Default Value** |\n|------------|---------------|-----------------|\n| `RC_DB_HOST` | The hostname or IP address of the database server |  |\n| `RC_DB_USER` | The name of the database user. **Attention!** You shall not use an administrator account. |  |\n| `RC_DB_PASS` | The password of the database user |  |\n| `RC_DB_NAME` | The name of the database | |\n| `RC_DES_KEY` | This key is used to encrypt the users IMAP password which is stored in the session record (and the client cookie if remember password is enabled). Please, provide a string of exactly 24 chars. | |\n| `RC_IMAP_SERVER_NAME` | The hostname of the IMAP server for picking up e-mails. | |\n| `RC_SMTP_SERVER_NAME` | The hostname of the SMTP server fpr sending e-mails. | |\n| `RC_DEFAULT_DOMAIN` | The default mail domain to be used. This saves typing effort when logging in for this domain as you only need to input the mailbox name. | |\n\n## Ports\n_docker-mailserver-roundcube_  exposes port 80 (the WebUI). No TLS support is built in. So you shall put your container behind an Ingress or Reverse Proxy that enforces HTTPS.\n\n## Running the Container\nThe [main mailserver project](https://github.com/technicalguru/docker-mailserver) has examples of container configurations:\n* [with docker-compose](https://github.com/technicalguru/docker-mailserver/tree/master/examples/docker-compose)\n* [with Kubernetes YAML files](https://github.com/technicalguru/docker-mailserver/tree/master/examples/kubernetes)\n* [with HELM charts](https://github.com/technicalguru/docker-mailserver/tree/master/examples/helm-charts)\n\n## Bootstrap and Setup\nOnce you have started your Roundcube container successfully, follow these instruction to setup your instance:\n\n1. Login to your database and create the Roundcube user with password and the appropriate database (values from your enviroment variables).\n1. Log into the container and edit file `/var/www/html/config/config.inc.php`. Enable the installer by setting `$config['enable_installer'] = true;` (line 113).\n1. Navigate in your browser to `/installer/`.\n1. Check the setup and click Next.\n1. Check that the database config is OK at \"DSN\".\n1. Click the \"Initialize database\" button to create the DB schema.\n1. Test the SMTP and IMAP configs and make adjustments if required\n1. Log into the container and edit file `/var/www/html/config/config.inc.php` again. Disable the installer by setting `$config['enable_installer'] = false;` (line 113).\n\nNow you can navigate to `/` in your browser and login with your mail account credentials.\n\n# Additional Roundcube customization\nYou can further customize `config.inc.php`. Please follow these instructions:\n\n1. Get a copy of the file from the `/var/www/html` folder. \n1. Customize your configuration file.\n1. Provide your customized file back into the `/var/www/html` by using a volume mapping.\n\n# Increase Upload size for attachments\nThe attachment size is controlled by the PHP configuration. The file must be placed in `/usr/local/etc/php/conf.d/`:\n\n```\nupload_max_filesize = 20M\npost_max_size = 20M\n```\n\nFor Kubernetes using the HELM chart, create the following ConfigMap:\n\n```\napiVersion: v1\nkind: ConfigMap\nmetadata:\n  name: mailserver-roundcube-upload\ndata:\n  upload.ini: |-\n    upload_max_filesize = 10M\n    post_max_size = 10M\n```\n\nAdd the following lines to your HELM values.yaml file:\n\n```\nadditionalContainerSpec:\n  volumeMounts:\n  - mountPath: /usr/local/etc/php/conf.d/upload.ini\n    name: roundcube-upload-config\n    subPath: upload.ini\nadditionalPodSpec:\n  volumes:\n  - name: roundcube-upload-config\n    configMap:\n      name: mailserver-roundcube-upload\n```\n\n\n# Issues\nThis Docker image is mature and supports my own mailserver in production. There are no known issues at the moment.\n\n\n# Contribution\nReport a bug, request an enhancement or pull request at the [GitHub Issue Tracker](https://github.com/technicalguru/docker-mailserver-roundcube/issues). Make sure you have checked out the [Contribution Guideline](CONTRIBUTING.md)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnicalguru%2Fdocker-mailserver-roundcube","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechnicalguru%2Fdocker-mailserver-roundcube","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnicalguru%2Fdocker-mailserver-roundcube/lists"}