{"id":28904830,"url":"https://github.com/aliasflare/aliasflare","last_synced_at":"2026-03-15T03:21:10.677Z","repository":{"id":300010839,"uuid":"1004414514","full_name":"Aliasflare/Aliasflare","owner":"Aliasflare","description":"Cloudflare-based email aliasing service that lets you create unlimited aliases for free","archived":false,"fork":false,"pushed_at":"2025-06-19T12:30:57.000Z","size":547,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-19T12:32:11.504Z","etag":null,"topics":["alias","aliases","anonaddy","cloudflare","cloudflare-email-routing","cloudflare-email-workers","cloudflare-workers","email","email-alias","mail","mail-alias","simplelogin"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aliasflare.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,"zenodo":null}},"created_at":"2025-06-18T15:30:53.000Z","updated_at":"2025-06-19T12:31:01.000Z","dependencies_parsed_at":"2025-06-19T12:44:30.274Z","dependency_job_id":null,"html_url":"https://github.com/Aliasflare/Aliasflare","commit_stats":null,"previous_names":["aliasflare/aliasflare"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Aliasflare/Aliasflare","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliasflare%2FAliasflare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliasflare%2FAliasflare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliasflare%2FAliasflare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliasflare%2FAliasflare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aliasflare","download_url":"https://codeload.github.com/Aliasflare/Aliasflare/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliasflare%2FAliasflare/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261126448,"owners_count":23113312,"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":["alias","aliases","anonaddy","cloudflare","cloudflare-email-routing","cloudflare-email-workers","cloudflare-workers","email","email-alias","mail","mail-alias","simplelogin"],"created_at":"2025-06-21T13:02:40.857Z","updated_at":"2026-03-15T03:21:10.654Z","avatar_url":"https://github.com/Aliasflare.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [!CAUTION]  \n\u003e This docuementation is outdated! Updates will follow soon! \n\n\u003cp align=\"center\"\u003e\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./core/webapp/public/logo_dark.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"./core/webapp/public/logo.png\"\u003e\n  \u003cimg alt=\"Logo\" src=\"./core/webapp/public/logo_dark.png\" width=400\u003e\n\u003c/picture\u003e\n\u003c/p\u003e\n\nAliasFlare is a lightweight, Cloudflare-based email aliasing service that lets you create unlimited aliases to forward incoming and outgoing emails to your real inbox. It supports full reverse-aliasing, so you can send replies from your alias addresses while keeping your personal email private.\n\n\u003e [!WARNING]  \n\u003e This project is currently in it's early stages, there might be breaking changes for Database Structure!  \n\u003e Always check the commits for possible breaking changes with regards to Database Structure!\n\n\u003e [!IMPORTANT]  \n\u003e Currently there is no proper error display for dialogs!   \n\u003e To figure out what is wrong please open the \u003cb\u003eDev Tools (Strg+F12)\u003c/b\u003e before confirming a dialog and look at the request/response there!   \n\u003e Fixing this is a high priority and proper error handling will come soon!\n\n\n\u003cdetails\u003e\n  \u003csummary\u003eScreenshots\u003c/summary\u003e\n  \u003cimg alt=\"Screenshot\" src=\"./docs/screenshots/PREVIEW_ALIASES.png\" width=\"24.8%\"\u003e \n  \u003cimg alt=\"Screenshot\" src=\"./docs/screenshots/PREVIEW_CATEGORIES.png\" width=\"24.8%\"\u003e \n  \u003cimg alt=\"Screenshot\" src=\"./docs/screenshots/PREVIEW_DESTINATIONS.png\" width=\"24.8%\"\u003e \n  \u003cimg alt=\"Screenshot\" src=\"./docs/screenshots/PREVIEW_LOGIN.png\" width=\"24.8%\"\u003e   \n  \u003cimg alt=\"Screenshot\" src=\"./docs/screenshots/PREVIEW_CREATECATEGORY.png\" width=\"24.8%\"\u003e \n  \u003cimg alt=\"Screenshot\" src=\"./docs/screenshots/PREVIEW_CREATEDESTINATION.png\" width=\"24.8%\"\u003e \n  \u003cimg alt=\"Screenshot\" src=\"./docs/screenshots/PREVIEW_CREATEALIAS.png\" width=\"24.8%\"\u003e \n\u003c/details\u003e\n\n## ✨ Features\n- Unlimited Aliases: Create as many email aliases as you need without any restrictions.\n- Seamless Forwarding: Effortlessly forward both incoming and outgoing emails to and from your real inbox.\n- Reverse-Aliasing: Reply from your alias address, maintaining privacy without revealing your personal email.\n- Cloudflare Powered: Enjoy fast and reliable email routing through Cloudflare's secure and scalable infrastructure.\n- Privacy Focused: Protect your personal inbox from spam and unwanted exposure while keeping your communication streamlined.\n- Easy to Use: Simple setup with no complex configurations, making email management effortless and secure.\n\n## 🛠 Configurtion\n### 1. Setup Cloudflare Account\n1. Create a Cloudflare Account at [https://dash.cloudflare.com/](https://dash.cloudflare.com/)\n2. Register your desired Domain at Cloudflare `(Account Home-\u003eDomains-\u003eAdd a domain)`\n3. Create an API Token `(Account-\u003eAPI Token-\u003eCreate Token)`  \n  3.1 Select `Edit Cloudflare Workers` template from `API token templates`  \n  3.2 Change `Token name` to `Aliasflare`  \n  3.3 Add permission `(Zone, Email Routing Rules, Edit)` (needed for binding the worker to incoming mails)   \n  3.4 Add permission `(Zone, Zone Settings, Edit)` (needed for enabling email routing)  \n  3.5 Add permission `(Account, D1, Edit)` (needed for creating the database)  \n  3.6 Add permission `(Account, Email Routing Addresses, Edit)` (needed for destinations)  \n  3.7 Select your account under `Account Resources` `(Include, YOUR ACCOUNT)`  \n  3.8 Select your domain under `Zone Resources` `(Include, Specific zone, YOUR DOMAIN)`  \n  3.9 Click on `Continue to summary` and then on `Create Token`  \n  3.10 NOTE DOWN YOUR TOKEN SECURELY! YOU WILL NEED IT LATER AND CANNOT VIEW IT IF THE TAB IS CLOSED!\n\n### 2. Setup GitHub Repository\n1. Fork this repository into your GitHub Account\n2. Goto your GitHub Repository\n3. Goto `Settings-\u003eSecrets and variables`\n4. Select `Secrets` and add the following secrets  \n  4.1 Add `CLOUDFLARE_API_TOKEN` with your before generated API Token  \n  4.2 Add `CLOUDFLARE_DOMAINS` containing your domains in a comma-seperated list   \n  4.3 (OPTIONAL) Add `CLOUDFLARE_WORKER_NAME` if you want to use another Cloudflare Worker  \n  4.4 (OPTIONAL) Add `CLOUDFLARE_DATABASE_NAME` if you want to use another Cloudflare D1 Database  \n  4.5 (OPTIONAL) Add `MAILGUN_API_KEY` if you setup your domain at mailgun for outgoing mails\n\n### 3. Deploy (look at \"Deployment \u0026 Upgrades\")\n\n### 4. Create your first user account\n1. Navigate to one of your configured domains\n2. Login using `admin` and `AliasflareAdmin1234`\n3. Goto `Settings` and change your password\n4. Select `Admin Mode` and goto `Users`\n5. Create your actual user by clicking the `(+)` in the Users table\n\n## 📦 Deployment \u0026 Updates\n\nFor initial deployment or after an update you have to redeploy your app and upgrade the database!\n\n### Deploying\n1. Goto your GitHub Repository\n2. Goto `Actions` tab\n3. Select `Deploy` at the left  \n4. Click on `Run workflow` and `Run workflow` again\n\n### Updating\n\u003e [!WARNING]  \n\u003e Only update to the latest version when a new GitHub release is created  \n\u003e Updating to commits during development is not recommended!\n\n1. Goto your GitHub Repository\n2. Goto `Code` tab\n3. Click on `Sync fork` and then `Update branch` \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliasflare%2Faliasflare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliasflare%2Faliasflare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliasflare%2Faliasflare/lists"}