{"id":39149866,"url":"https://github.com/lyubenblagoev/emailctl","last_synced_at":"2026-01-17T21:38:50.467Z","repository":{"id":57586514,"uuid":"105970559","full_name":"lyubenblagoev/emailctl","owner":"lyubenblagoev","description":"Command line interface (CLI) for the Postfix REST Server","archived":false,"fork":false,"pushed_at":"2021-03-16T16:12:18.000Z","size":37,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-06-20T12:06:28.233Z","etag":null,"topics":["cli","go","postfix-rest-server","rest-cllient"],"latest_commit_sha":null,"homepage":"","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/lyubenblagoev.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":"2017-10-06T05:32:01.000Z","updated_at":"2023-11-08T20:02:48.000Z","dependencies_parsed_at":"2022-09-13T12:42:48.023Z","dependency_job_id":null,"html_url":"https://github.com/lyubenblagoev/emailctl","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/lyubenblagoev/emailctl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lyubenblagoev%2Femailctl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lyubenblagoev%2Femailctl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lyubenblagoev%2Femailctl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lyubenblagoev%2Femailctl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lyubenblagoev","download_url":"https://codeload.github.com/lyubenblagoev/emailctl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lyubenblagoev%2Femailctl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28518648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T18:55:29.170Z","status":"ssl_error","status_checked_at":"2026-01-17T18:55:03.375Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cli","go","postfix-rest-server","rest-cllient"],"created_at":"2026-01-17T21:38:50.222Z","updated_at":"2026-01-17T21:38:50.435Z","avatar_url":"https://github.com/lyubenblagoev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# emailctl\n\nemailctl is a command line interface (CLI) for the [Postfix Rest Server][1] V1 API. \n\nemailctl currently implements all [Postfix Rest Server][1] APIs (domains, accounts, aliases, automatic sender and recipient BCC).\n\n```\nemailctl is a command line interface (CLI) to the Postfix Rest Server\n\nUsage:\n  emailctl [command]\n\nAvailable Commands:\n  account       Account commands\n  alias         Alias commands\n  auth          Authentication commands\n  domain        Domain commands\n  help          Help about any command\n  recipient-bcc recipient-bcc commands\n  sender-bcc    sender-bcc commands\n  version       Prints the version number of emailctl\n\nFlags:\n      --config string   config file (default is $HOME/.emailctl.yaml)\n  -h, --help            help for emailctl\n\nUse \"emailctl [command] --help\" for more information about a command.\n\n```\n\n## Installation\n\n### Install from source\n\nIf you have a Go environment configured, you can install the latest development version of `emailctl` directly from my GitHub account from the command line like so: \n\n```\ngo get github.com/lyubenblagoev/emailctl/...\n```\n\nwhich will install the executable in your GOPATH, or you can build it with the following command and move the executable somewhere under PATH:\n\n```\ngo build -o some-path/emailctl ./cmd/emailctl\n```\n\n## Configuration\n\nBy default `emailctl` will load a configuration file from `$HOME/.emailctl.yaml`. Make sure to set proper permissions to this file, so no one else can read it, as `emailctl` uses it to store the access and refresh tokens.\n\n### Configuration options\n\n* `https` - Boolean setting for whether to use HTTPS for connection to the [Postfix Rest Server][1].\n* `host` - The hostname or IP address of the machine on which the [Postfix Rest Server][1] is running.\n* `port` - The port on which the [Postfix Rest Server][1] is listening.\n\nExample: \n\n```yaml\nhttps: false\nhost: localhost\nport: 8080\n```\n\nThe above values are the defaults. You can omit options that don't change the default values.\n\n## Examples\n\nBelow are a few usage examples:\n\n### Authentication\n\n* Log in\n\n```\nemailctl auth login admin@example.com\n```\n\n* Log out\n\n```\nemailctl auth logout\n```\n\n### Domain API\n\n* List all domains on your server:\n\n```\nemailctl domain list\n```\n\n* Show information for specific domain:\n\n```\nemailctl domain show example.com\n```\n\n* Add a new domain: \n\n```\nemailctl domain add example.com\n```\n\n* Delete a domain: \n\n```\nemailctl domain delete example.com\n```\n\n* Disable a domain on your server:\n\n```\nemailctl domain disable example.com\n```\n\n* Rename a domain\n\n```\nemailctl domain rename example.com example.net\n```\n\n### Account API\n\n* List accounts for domain:\n\n```\nemailctl account list example.com\n```\n\n* Show information for account in specific domain:\n\n```\nemailctl account show example.com user1\n```\n\n* Delete account:\n\n```\nemailctl account delete example.com user1\n```\n\n* Disable account: \n\n```\nemailctl account disable example.com user1\n```\n\n* Change password for account:\n\n```\nemailctl account password example.com user1\nPassword: \nConfirm password: \n```\n\n## More information\n\nTo learn more about the features and commands available run\n\n```\nemailctl help [command [sub-command]...]\n```\n\nor \n\n```\nemailctl [command [sub-command]...] --help\n```\n\n[1]: https://github.com/lyubenblagoev/postfix-rest-server \"Postfix Rest Server\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flyubenblagoev%2Femailctl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flyubenblagoev%2Femailctl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flyubenblagoev%2Femailctl/lists"}