{"id":20128035,"url":"https://github.com/camelotproject/smtp-dev-server","last_synced_at":"2025-10-27T08:04:47.318Z","repository":{"id":59089432,"uuid":"535351541","full_name":"CamelotProject/smtp-dev-server","owner":"CamelotProject","description":"Fake SMTP server for local development","archived":false,"fork":false,"pushed_at":"2022-10-06T03:43:09.000Z","size":160,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-13T08:27:04.360Z","etag":null,"topics":["developer-tools","mime","rfc2822","rfc822","smtp-server","testing"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/CamelotProject.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":"2022-09-11T16:08:35.000Z","updated_at":"2024-05-08T11:15:25.000Z","dependencies_parsed_at":"2022-09-25T08:13:05.184Z","dependency_job_id":null,"html_url":"https://github.com/CamelotProject/smtp-dev-server","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CamelotProject%2Fsmtp-dev-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CamelotProject%2Fsmtp-dev-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CamelotProject%2Fsmtp-dev-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CamelotProject%2Fsmtp-dev-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CamelotProject","download_url":"https://codeload.github.com/CamelotProject/smtp-dev-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241572213,"owners_count":19984235,"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":["developer-tools","mime","rfc2822","rfc822","smtp-server","testing"],"created_at":"2024-11-13T20:25:08.304Z","updated_at":"2025-10-27T08:04:42.278Z","avatar_url":"https://github.com/CamelotProject.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"SMTP Development Server\n=======================\n\n**FOR USE IN DEVELOPMENT ENVIRONMENTS ONLY**\n\nA simple and very fake SMTP server for development/testing purposes. Because, why not.\n\n**Features**\n - SMTP server that can accept \u0026 store valid RFC822/RFC2822 email\n - HTTP server/site as a client interface to the messages received\n\n**WARNING: Do not expose running server ports to open networks and do not run as \n`root` or an admin user! There are ZERO security features built into these \nservers.** \n\nInstallation\n------------\n\nGlobally:\n\n```console\n$ composer global require camelot/smtp-dev-server\n```\n\nAs a development dependency for your project:\n\n```console\n$ composer require --dev camelot/smtp-dev-server\n```\n\nConfiguration\n-------------\n\nConfiguration is handled via environment variables. \n\n```shell\nSMTP_LOG_LEVEL=debug\nSMTP_LOG_FILE=\"/path/to/smtp.log\"\nSMTP_SPOOL_DIR=\"/path/to/spool\"\nHTTP_LOG_LEVEL=debug\nHTTP_LOG_FILE=\"/path/to/http.log\"\n```\n\nSee the `.env` file in this directory for an example if you're cloning this \nrepository, you can create a `.env.local` file to override any of the values in\nthe `.env` file.\n\nUse\n---\n\nBoth servers have two output targets, console and PSR logger.\n\nConsole output levels are managed by passing `-v`, `-vv`, or `-vvv` as options\non the command line.\n\nLogger output is managed via environment variables that are used internally to \nconfigure the loggers.\n\nFor example: \n```\n$ SMTP_LOG_LEVEL=debug vendor/bin/smtp-dev-server -vvv\n``` \n\n### Server\n\n![image](https://user-images.githubusercontent.com/1427081/194073098-e655ea46-bda4-4c63-8d7e-c193f4636a82.png)\n\nTo start the server, simply run:\n\n```console\n$ vendor/bin/smtp-dev-server\n```\n\nThis will output internal information to STDOUT. You can specify verbosity with\nthe command options below.\n\nServer can be stopped by sending a signal, e.g. `CTRL+C`.\n\n#### Arguments\n\n```\n  backing          Storage type (null, memory, mailbox) [default: \"mailbox\"]\n```\n\n#### Options\n\n```\n  -i, --ip=IP            TCP/IP address [default: \"127.0.0.1\"]\n  -p, --port=PORT        Port to listen on [default: 2525]\n  -r, --retries=RETRIES  Number of times to retry connecting to the server socket address if it is currently in use [default: 10]\n  -h, --help             Show help\n  -v|vv|vvv, --verbose   Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n```\n\n### Client\n\n![image](https://user-images.githubusercontent.com/1427081/194073411-604cb0b9-0901-48ee-ae0a-86459394ae3c.png)\n![image](https://user-images.githubusercontent.com/1427081/194208872-28f7b627-846a-43ce-81d3-52c6c0a3b90d.png)\n\nTo start the server, simply run:\n\n```console\n$ vendor/bin/smtp-dev-client\n```\n\nThis will output internal information to STDOUT. You can specify verbosity with \nthe command options below.\n\nServer can be stopped by sending a signal, e.g. `CTRL+C`.\n\n#### Arguments\n\n```\n  backing          Storage type (null, memory) [default: \"null\"]\n```\n\n#### Options\n\n```\n  -i, --ip=IP            TCP/IP address [default: \"127.0.0.1\"]\n  -p, --port=PORT        Port to listen on [default: 2580]\n  -r, --retries=RETRIES  Number of times to retry connecting to the server socket address if it is currently in use [default: 10]\n  -h, --help             Show help\n  -v|vv|vvv, --verbose   Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n```\n\nOpen (default) `http://127.0.0.1:2580` to view \u0026 manage messages received by the SMTP server component.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcamelotproject%2Fsmtp-dev-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcamelotproject%2Fsmtp-dev-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcamelotproject%2Fsmtp-dev-server/lists"}