{"id":18402467,"url":"https://github.com/filosottile/alum","last_synced_at":"2025-06-20T06:37:53.485Z","repository":{"id":17034917,"uuid":"19799136","full_name":"FiloSottile/alum","owner":"FiloSottile","description":"A forwarding mail server inspired by @alum.mit.edu","archived":false,"fork":false,"pushed_at":"2016-03-22T16:49:13.000Z","size":680,"stargazers_count":19,"open_issues_count":8,"forks_count":3,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-06T00:38:55.997Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/FiloSottile.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}},"created_at":"2014-05-14T23:04:21.000Z","updated_at":"2025-03-06T00:51:36.000Z","dependencies_parsed_at":"2022-09-24T12:44:58.176Z","dependency_job_id":null,"html_url":"https://github.com/FiloSottile/alum","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/FiloSottile/alum","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FiloSottile%2Falum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FiloSottile%2Falum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FiloSottile%2Falum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FiloSottile%2Falum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FiloSottile","download_url":"https://codeload.github.com/FiloSottile/alum/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FiloSottile%2Falum/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260897577,"owners_count":23079220,"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-11-06T02:42:34.479Z","updated_at":"2025-06-20T06:37:48.470Z","avatar_url":"https://github.com/FiloSottile.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"alum\n====\n\nA forwarding mail server inspired by @alum.mit.edu\n\n\n## What's in the package\n\n* A secure Postfix instance that will ONLY forward mail, according to the aliases file\n* Full opportunistic TLS support\n* Automatic security updates, with reboot, and emails on error to `postmaster@alum.example.com`\n* Daily Tarsnap backups of the aliases file\n* A Ansible playbook to setup all of this\n\n\n## Usage\n\n* Create a Tarsnap key and put it in `tarsnap.key`\n* Generate a self-signed key+certificate and put it in smtpd.pem\n* Start a Ubuntu 14.04 LTS machine\n* Make sure you can ssh into the machine, and that sudo is passwordless\n* Create a `inventory.ini` file like this\n```\n[alum]\n98.25.536.22\n```\n* Run\n```\nansible-playbook -i inventory.ini \\\n    -e domain=alum.example.com \\\n    playbook.yml\n```\nInclude `-e mirror=alum.example.org` if you want to support multiple domains.\n* Set the DNS A record for `alum.example.com` to point to the machine, and the MX record of `alum.example.com` to `alum.example.com`\n\n\n## Adding aliases\n\nAdd them like this\n\n```\npostmaster@alum.example.com me@example.com\njoe@alum.example.com joe@gmail.com\n\u003calias-email-with-domain\u003e \u003cactual-recipient-email\u003e\n```\n\nto `/etc/postfix/virtual` and then run\n\n```sh\n# postmap /etc/postfix/virtual\n# postfix reload\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilosottile%2Falum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffilosottile%2Falum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilosottile%2Falum/lists"}