{"id":15677805,"url":"https://github.com/hardware/mailserver-rancher","last_synced_at":"2025-10-18T07:40:18.370Z","repository":{"id":151489498,"uuid":"123030014","full_name":"hardware/mailserver-rancher","owner":"hardware","description":"hardware/mailserver Rancher Catalog","archived":false,"fork":false,"pushed_at":"2018-03-05T07:54:25.000Z","size":81,"stargazers_count":13,"open_issues_count":1,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-24T04:14:40.372Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/hardware/mailserver","language":"Smarty","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hardware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2018-02-26T21:02:02.000Z","updated_at":"2023-02-05T16:32:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"2d178f9d-c9df-4c8f-b703-ff9480f03f79","html_url":"https://github.com/hardware/mailserver-rancher","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardware%2Fmailserver-rancher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardware%2Fmailserver-rancher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardware%2Fmailserver-rancher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hardware%2Fmailserver-rancher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hardware","download_url":"https://codeload.github.com/hardware/mailserver-rancher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250560056,"owners_count":21450173,"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":[],"created_at":"2024-10-03T16:12:02.637Z","updated_at":"2025-10-18T07:40:18.281Z","avatar_url":"https://github.com/hardware.png","language":"Smarty","funding_links":[],"categories":[],"sub_categories":[],"readme":"## hardware/mailserver Rancher Catalog\n\n### Description\n\nThis catalog provides a basic template to easily deploy an email server based on [hardware/mailserver](https://github.com/hardware/mailserver). To use it, just add this repository to your Rancher system as a catalog in `Admin \u003e Settings` page.\n\n### Prerequisites\n\n* Linux host with at least 2GB of memory and 20GB of local disk\n* Supported version of Docker\n* Rancher server\n* Basic understanding of e-mail ecosystem and standards\n\nAnd you **MUST** read this :\n\n* https://github.com/hardware/mailserver#system-requirements\n* https://github.com/hardware/mailserver#prerequisites\n\n\n### How to setup\n\n1. Add this catalog in `Admin \u003e Settings` page : https://github.com/hardware/mailserver-rancher.git\n\n2. Select 'mailserver' from the catalog menu.\n\n3. Fill in all required fields and adapt to your needs. For more information, read the [documentation](https://github.com/hardware/mailserver).\n\n4. Lauch the mailserver stack. At first launch, the container takes few minutes to generate SSL certificates, DKIM keypair and update clamav database, all of this takes some time (1/2 minutes). You can check the startup logs with Rancher admin panel.\n\n5. Now, you must setup a reverse proxy to access your administration, webmail and spam WebUIs. Add a label in the host instance configuration, in `Infrastructure \u003e Hosts` page, named `traefik_lb` with a value equal to `true`. Traefik will be deployed in all hosts with this label.\n\n6. Select 'traefik' load balancer from the community catalog. Fill in all required fields and adapt to your needs. If you choose API integration method, don't forget to create an API key for Traefik in `API \u003e Keys` page.\n\n7. Once traefik is started, you can setup Postfixadmin and Rainloop configuration :\n    * Postfixadmin : [Postfixadmin initial configuration](https://github.com/hardware/mailserver/wiki/Postfixadmin-initial-configuration). The setup can be used from the Rancher web console :\n    ![](https://i.imgur.com/9fVKVPd.png)\n    * Rainloop : [Rainloop initial configuration](https://github.com/hardware/mailserver/wiki/Rainloop-initial-configuration)\n\n8. Done, congratulation !\n\n### Custom mailserver SSL certificate\n\n1. Request your SSL certificate in `${VOLUMES_ROOT_PATH}/ssl/live/mail.domain.tld` with an ACME client if you use Let's Encrypt, otherwise get your SSL certificate with the method provided by your certification authority.\n2. Enable the custom SSL certificate support in rancher mailserver catalog.\n\nFor more information, read this : [custom certificates](https://github.com/hardware/mailserver/blob/master/README.md#custom-certificates)\n\nIf you do not use your own trusted SSL certificate, a default self-signed one (RSA 4096 bits SHA2) is added here : `${VOLUMES_ROOT_PATH}/mail/ssl/selfsigned/{cert.pem, privkey.pem}`.\n\n### List of all webservices available after installation :\n\n* Rspamd dashboard : https://spam.domain.tld/\n* Administration : https://postfixadmin.domain.tld/\n* Webmail : https://webmail.domain.tld/\n\n### Email client settings :\n\n* IMAP/SMTP username : user@domain.tld\n* Incoming IMAP server : mail.domain.tld\n* Outgoing SMTP server : mail.domain.tld\n* IMAP port : 993\n* SMTP port : 587\n* SIEVE port : 4190\n* IMAP Encryption protocol : SSL/TLS\n* SMTP Encryption protocol : STARTTLS\n* SIEVE Encryption protocol : STARTTLS\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhardware%2Fmailserver-rancher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhardware%2Fmailserver-rancher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhardware%2Fmailserver-rancher/lists"}