{"id":19000993,"url":"https://github.com/pepipost/pepipost-cli","last_synced_at":"2026-03-07T20:05:09.313Z","repository":{"id":144271892,"uuid":"155542820","full_name":"pepipost/pepipost-cli","owner":"pepipost","description":"Linux Agent which will help you to perform various operations with respect to sending email,fetching reports, managing domains and many more","archived":false,"fork":false,"pushed_at":"2019-07-21T15:18:52.000Z","size":1101,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-10T07:22:50.483Z","etag":null,"topics":["api-client","cli","deb","linux-agent","linux-cli","mailing","oneliners","pepipost","rpm","smtp-client","terminal-app","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pepipost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2018-10-31T10:59:56.000Z","updated_at":"2024-03-11T16:21:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"180e1e1b-c01d-4599-8101-c9a474be1a76","html_url":"https://github.com/pepipost/pepipost-cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pepipost/pepipost-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pepipost","download_url":"https://codeload.github.com/pepipost/pepipost-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30229590,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T19:01:10.287Z","status":"ssl_error","status_checked_at":"2026-03-07T18:59:58.103Z","response_time":53,"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":["api-client","cli","deb","linux-agent","linux-cli","mailing","oneliners","pepipost","rpm","smtp-client","terminal-app","ubuntu"],"created_at":"2024-11-08T18:09:29.571Z","updated_at":"2026-03-07T20:05:09.292Z","avatar_url":"https://github.com/pepipost.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pepipost-cli :penguin:\r\n\r\n![pepipost-cli](http://app1.falconide.com/integration_imgs/pepi-cli.png)\r\n\r\n## Introduction\r\n\r\nIf you don't want to spend time in setting up the environment and write the code to simply send an email, then this CLI is the solution. This Linux agent is capable of sending emails in both the situations whether your outgoing SMTP port is blocked or not. In order to enable this, we have build support for both custom SMTP and API (in case email ports are blocked).\r\n\r\nThis CLI not only sends email but also keeps track of the actually email activity like whether the email is delivered, bounced, opened, clicked etc. And, all these data will be available to you in real time.\r\n\r\nThis CLI is developed in generic way. So that, even if you are not using Pepipost you can send email through other SMTP using this CLI.\r\n\r\nFor apiEmail and tracking of the email you need to have [Pepipost](http://www.pepipost.com/?utm_campaign=GitHublinuxagent\u0026utm_medium=Github\u0026utm_source=Githublinuxagent) account.\r\n\r\n*Note :: Please make sure your outgoing port 25,587,463 is open for sending SMTP mail*\r\n        *\u0026 outgoing port 80,443 is open for sending API mail*\r\n\t\r\n*This repo is under **testing phase** their might be bugs*\r\n\r\n## Installation\r\n\r\n`cd $GOPATH/src/ \u0026\u0026 git clone github.com/pepipost/pepipost-cli.git \u0026\u0026 cd $GOPATH/src/pepipost-cli \u0026\u0026 go install cmd/pepipost/pepipost.go \u0026\u0026 $GOPATH/bin/./pepipost -h`\r\n\r\n* Install using RPM\r\n\r\n`cd /tmp/ \u0026\u0026 wget https://pepipost.com/centos/Pepipost-1.0.1-1.x86_64.rpm \u0026\u0026 sudo rpm -Uvh Pepipost-1.0.1-1.x86_64.rpm`\r\n\r\n* Install using deb\r\n\r\n`cd /tmp/ \u0026\u0026 wget https://pepipost.com/pepipost_1.0.0-2_amd64.deb \u0026\u0026 sudo dpkg -i pepipost_1.0.0-2_amd64.deb`\r\n\r\n* Install using yum\r\n\r\n  Open editor of your choice with sudo access we will use vim here\r\n\r\n  ```\r\n  sudo vim /etc/yum.repos.d/pepipost.repo\r\n  ```\r\n  Copy and paste the below lines and save file\r\n  \r\n  ```\r\n   [pepipost]\r\n   name=Pepipost Repository\r\n   baseurl=https://pepipost.com/centos/\r\n   enabled=1\r\n   gpgcheck=0\r\n\r\n  ```\r\n   Installation \r\n  \r\n  ```\r\n   yum install Pepipost\r\n  ```\r\n\r\n## Setting Enviroment variable.\r\n\r\nWe recommend to set SMTP username, Password and Pepipost **APIKEY** has enviroment variable, which can be available after login to [Pepipost](https://app.pepipost.com/) app -\u003e settings -\u003e Integration \r\n\r\nreplace the credentials with your account and copy paste below in your ~/.bashrc or ~/.bash_profile or checkout [setting enviroment variable](https://www.digitalocean.com/community/tutorials/how-to-read-and-set-environmental-and-shell-variables-on-a-linux-vps) / [info on setting env](https://codeburst.io/linux-environment-variables-53cea0245dc9)\r\n\r\n\r\n```shell \r\nexport PEPISMTPPASS=\"myaccount@345\"\r\nexport PEPISMTPUSER=\"smtpusernameispepi\"\r\nexport PEPIKEY=\"e8a874fbd6f35fffdsaXXXXXfa230879205\"\r\n\r\n```\r\n\r\n## Usage\r\n\r\n* Sending SMTP email using command line interface.\r\n\r\n`pepipost smtpEmail -h`\r\n\r\n   **OR**\r\n\r\n```shell\r\n  \r\n pepipost smtpEmail \r\n \r\n\t-d\tsmtp.pepipost.com \r\n\t-P\t25/465/587\r\n\t-u\tsmtpusername                                            #this will override your enviroment variable(not recommended)\r\n\t-p\tsmtpuserpassword                                        #this will override your enviroment variable(not recommended)\r\n\t-fn\tfromname\r\n\t-f\tinfo@yourregisterdomainwithpepipost.com \r\n\t-t\tmyrecipient1@gmail.com,myrecipient2@gmail.com           #can pass multiple toaddress comma separated \r\n\t-c\tmyrecipientcc1@gmail.com, myrecipientcc2@gmail.com      #can pass multiple cc address comma separated\r\n\t-B\tmybcc1@gmail.com,mybcc2@gmail.com                       #can pass multiple bcc address comma separated\r\n\t-r \treplytoid@something.com                                 #replytoid for your email\r\n\t-s \t\"Subject Line :: SMTPMAIL v1.0.0\"                       #subject of your email\r\n\t-b \t\"This is text email body from pepipost.\"                #body of your email\r\n\t-z\t\"\u003chtml\u003e\u003cbody\u003e\u003c/body\u003e\u003c/html\u003e\"                            #can pass html as text command line\r\n\t-Z \t\"/tmp/htmldemo.html\"                                    #can pass html file from path  \r\n\t-h \t\"X-PepipostHeader,DEMO-786-XXX-435\"                     #customized header you want to pass\r\n\t-a \t\"/tmp/mypdfforpepi.pdf\"                                 #attachment if any.\r\n\r\n```\r\n\r\n* Sending API email using command line interface\r\n\r\n`pepipost apiEmail -h`\r\n\r\n   **OR**\r\n\r\n```shell\r\n\r\n pepipost apiEmail\r\n\r\n\t-K  \"kfdjkanf dasjkfi38yirekjbfidsnk\"               #this will override your enviroment variable(not recommended)\r\n\t-fn\tfromname\r\n\t-f\tinfo@yourregisterdomainwithpepipost.com\r\n\t-t\trecipient1@gmail.com \r\n\t-c\trcc1@gmail.com,rcc2@gmail.com                   #can pass multiple cc address comma separated\r\n\t-B\tbcc@gmail.com\r\n\t-r \treplytoid@something.com\r\n\t-s \t\"Subject Line :: APIMAIL v1.0.0\"                #subject of your email\r\n\t-b \t\"This is text email from pepipost.\"             #body of your email\r\n\t-z\t\"\u003chtml\u003e\u003cbody\u003emybody\u003c/body\u003e\u003c/html\u003e\"              #can pass html as text command line \r\n\t-Z \t\"/tmp/htmldemo.html\"                            #can pass html file from path \r\n\t-h \t\"X-PepipostHeader,DEMO-786-XXX-435\"             #customized header you want to pass\r\n\t-a \t\"/tmp/mypdfforpepi.pdf\"                         #attachment if any can pass multiple\r\n\r\n```\r\n* Fetching logs for email activity\r\n\r\n`pepipost fetchLogs -h`\r\n\r\n   **OR**\r\n\r\n```shell\r\n pepipost fetchLogs\r\n\r\n\t-K \t\tdfadfadfjdkfjiojrkldfniodsjf34iu38oirn3\t\t#this will override your enviroment variable(not recommended)\t\t\t\t\t\t\t\t\t\t#\r\n\t-e \t\tprocessed,open,click,unsubscribe,bounce,softbounce,spam,invalid,dropped,hardbounce\t#by default it will consider all\r\n\t-srt \t\tasc,desc\t                        #by default it will be ascending\r\n\t-stdate\t\t2019-02-11\t                        #by default it will take last 90 days\t\t\r\n\t-edate\t\t2019-02-11\t                        #by default it will be for today\r\n\t-s      \t\"excat subject you want to search\"\t\t\t\t\t\t\t\t\t\t\t\t\t\r\n\t-l\t\t5\t\t\t\t\t#limit max=100 , default =10 \r\n\t-o\t\t12\t\t\t\t\t#Point in the list to begin retrieving data\r\n\t-x \t\t\"search using x-apiheader pass\"\t\t#Filter logs based on x-apiheader\r\n\t-m \t\tmyemail@gmail.com\t\t\t#Filter logs based on email\r\n\t-fa\t\tinfo@pepipost.com\t\t\t#Filter logs based on fromaddress\r\n\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpepipost%2Fpepipost-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpepipost%2Fpepipost-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpepipost%2Fpepipost-cli/lists"}