{"id":16444910,"url":"https://github.com/jaymon/stockton","last_synced_at":"2025-03-21T05:30:34.135Z","repository":{"id":57471578,"uuid":"52633904","full_name":"Jaymon/stockton","owner":"Jaymon","description":"Quickly setup an email server to forward a personal domain to any email address","archived":false,"fork":false,"pushed_at":"2019-07-18T22:02:47.000Z","size":4987,"stargazers_count":4,"open_issues_count":31,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-17T21:43:33.943Z","etag":null,"topics":["email","mailserver","postfix","proxy-server"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Jaymon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-26T21:28:59.000Z","updated_at":"2020-08-12T20:37:04.000Z","dependencies_parsed_at":"2022-09-26T17:40:26.609Z","dependency_job_id":null,"html_url":"https://github.com/Jaymon/stockton","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/Jaymon%2Fstockton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaymon%2Fstockton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaymon%2Fstockton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaymon%2Fstockton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jaymon","download_url":"https://codeload.github.com/Jaymon/stockton/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244745628,"owners_count":20503042,"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","mailserver","postfix","proxy-server"],"created_at":"2024-10-11T09:42:35.149Z","updated_at":"2025-03-21T05:30:32.773Z","avatar_url":"https://github.com/Jaymon.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stockton\n\nYou know, Stockton, because it assists the Mailman.\n\n\n## Let me paint you a word picture\n\nYou have an existing email address that you use for everything, say `joecool@gmail.com`, and you like this email address, you really do. But your mom told you it's time to grow up and so you purchased a super fancy schmancy domain, `super-cool-domain.com` with the intent to up your email address game. You just know you'll look so adult with `joecool@super-cool-domain.com` on your business cards.\n\nThere's just one flaw in your master plan, it took you so long to get `joecool@gmail.com` setup with the filters the way you like them, and you have 2-factor setup, it would be a shame to start all over fresh, this is where Stockton comes in.\n\nStockton is an email proxy server, its goal is to easily allow you to forward one email address, say `joecool@super-cool-domain.com` to another email account, say your beloved `joecool@gmail.com`, transparently, and with as little hassle as possible.\n\n\n## So how do I use it?\n\nI run it on Ubuntu 14.04, so that's all that's been tested.\n\nThen you need to install it, use pip:\n\n    $ sudo pip install stockton\n\nThen, after installation, just run:\n\n    $ sudo stockton install super-cool-domain.com \\\n    \u003e --proxy-email=joecool@gmail.com \\\n    \u003e --mailserver=mail.super-cool-domain.com \\\n    \u003e --smtp_password=\"...\"\n\nThat will setup Stockton and report what dns changes you will need to make to `super-cool-domain.com` in order to get everything working correctly. Stockton will automatically setup modern email things like [DKIM](http://www.dkim.org/), [SPF](http://www.openspf.org/), and [SRS](http://www.openspf.org/SRS) so your emails won't get lost in spam folders everwhere.\n\n\n### Domain files\n\nStockton can, most likely, host as many domains as you want to throw at it, and you can configure those domains using configuration files, so let's say you had a file like this:\n\n```\n# config file for super-cool-domain.org\n\n# let's send some email to joe, some to his super wonderful wife, and some to both of them\njoecool@super-cool-domain.org                     joecool@gmail.com\njanecool@super-cool-domain.org                    janecool@gmail.com\nfamily@super-cool-domain.org                      joecool@gmail.com,janecool@gmail.com\n\n# all stray emails should go to Joe\n@super-cool-domain.org                            joecool@gmail.com\n```\n\nNow you can add your new `super-cool-domain.org` to your mailserver using:\n\n    $ stockton add-domain super-cool-domain.org --proxy-file=/path/to/domain.config\n\nAnd Stockton will add that domain to your mailserver and let you know what dns changes you need to make to make your new domain work.\n\nIf you ever need to update your emails list, just update your file and run:\n\n    $ stockton update-domain-proxy --proxy-file=/path/to/domain.config\n\n\n## FAQ\n\n### Why did you write this?\n\nGood question, I'm glad you asked, turns out I've been a little liberal with the email addresses during the 13+ years I've owned my own domain, I gave some addresses to my parents, some more to my siblings, even my lovely wife got in on the action, and to top it all off, I've probably given out 300-400 unique email addresses in my various travels around the internets (just because!).\n\nSo when the time came to finally, (finally!) update my aging mailserver, I had trouble finding a hosted solution that worked for my particular use case (400+ unique email addresses, going to a few dozen unique email addresses) and Stockton was born.\n\nStockton is designed for my specific use case, multiple domains, all forwarding to different email addresses, if you have this use case, feel free to give it a spin, if not, then I'd use Gmail.\n\n\n### Why the name Stockton?\n\nI'm a fan of 1990's Utah Jazz references, here are some animated gifs to illustrate Stockton assisting the Mailman...\n\n![](https://github.com/Jaymon/stockton/blob/master/images/stockton-to-malone-3.gif)\n\n![](https://github.com/Jaymon/stockton/blob/master/images/stockton-to-malone-2.gif)\n\n![](https://github.com/Jaymon/stockton/blob/master/images/stockton-to-malone-1.gif)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaymon%2Fstockton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaymon%2Fstockton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaymon%2Fstockton/lists"}