{"id":15674456,"url":"https://github.com/rgl/mail-vagrant","last_synced_at":"2025-09-13T12:38:20.457Z","repository":{"id":139753138,"uuid":"59424061","full_name":"rgl/mail-vagrant","owner":"rgl","description":"A Mail Server in a Vagrant sandbox","archived":false,"fork":false,"pushed_at":"2019-09-29T10:17:22.000Z","size":416,"stargazers_count":13,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-06T23:13:48.856Z","etag":null,"topics":["dovecot","postfix","smtp","vagrant"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rgl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2016-05-22T17:05:48.000Z","updated_at":"2023-04-14T21:38:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"3c786dd4-5ea2-4bb2-bbec-37f5267e0427","html_url":"https://github.com/rgl/mail-vagrant","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rgl/mail-vagrant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgl%2Fmail-vagrant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgl%2Fmail-vagrant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgl%2Fmail-vagrant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgl%2Fmail-vagrant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rgl","download_url":"https://codeload.github.com/rgl/mail-vagrant/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgl%2Fmail-vagrant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274961748,"owners_count":25381892,"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","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["dovecot","postfix","smtp","vagrant"],"created_at":"2024-10-03T15:45:05.505Z","updated_at":"2025-09-13T12:38:20.434Z","avatar_url":"https://github.com/rgl.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"This is a [Vagrant](https://www.vagrantup.com/) Environment for a Mail Server. It provides the [Message Transfer Agent (MTA)](https://en.wikipedia.org/wiki/Message_transfer_agent) and the [Mail Delivery Agent (MDA)](https://en.wikipedia.org/wiki/Mail_delivery_agent).\n\nThis lets you easily test your application code against a real sandboxed Mail Server.\n\nIt uses the following software stack:\n\n* [Postfix](http://www.postfix.org/) to the handle mail storage, reception, and transmission using the [Simple Mail Transfer Protocol (SMTP)](https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol).\n  * Also show how to configure Postfix in Satellite mode to relay emails to the Postfix server.\n  * Also show how to configure nullmailer to relay emails to the Postfix server.\n* [Dovecot](http://www.dovecot.org/) to access the mail storage using the [Internet Message Access Protocol (IMAP)](https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol).\n* Dovecot for providing User Authentication to Postfix ([SMTP AUTH](https://en.wikipedia.org/wiki/SMTP_Authentication)) through the [Simple Authentication and Security Layer (SASL)](https://en.wikipedia.org/wiki/Simple_Authentication_and_Security_Layer).\n* [Dnsmasq](http://thekelleys.org.uk/dnsmasq/doc.html) to handle the internal [Domain Name System (DNS)](https://en.wikipedia.org/wiki/Domain_Name_System).\n* [nginx](http://nginx.org/en/) to serve the [Automatic Mail Account Configuration (aka Autoconfiguration)](https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat) endpoint.\n\n# Usage\n\nBuild and install the [Ubuntu Base Box](https://github.com/rgl/ubuntu-vagrant).\n\nRun `vagrant up mail` to configure the `mail.example.com` mail server environment.\n\nRun `vagrant up satellite` to configure the `satellite.example.com` environment in Postfix Satellite mode that relays all mails to the mail server environment.\n\nConfigure your system `/etc/hosts` file with the `example.com` and `mail.example.com` domains:\n\n    192.168.33.254 example.com\n    192.168.33.254 mail.example.com\n\nAccess http://mail.example.com and follow the instructions to configure your Mail Client with a pre-configured account (all use the `password` password):\n\n    alice@example.com\n    bob@example.com\n    carol@example.com\n    dave@example.com\n    eve@example.com\n    frank@example.com\n    grace@example.com\n    henry@example.com\n\nThis also has some pre-configured aliases to `alice@example.com`:\n\n    root\n    abuse\n    postmaster\n    hostmaster\n    mailer-daemon\n\nAt http://mail.example.com/examples you have some examples on how to programmatically use the mail server (e.g. from Python).\n\nTo troubleshoot, watch the Mail Server logs with `vagrant ssh` and `journalctl --follow`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frgl%2Fmail-vagrant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frgl%2Fmail-vagrant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frgl%2Fmail-vagrant/lists"}