{"id":46293347,"url":"https://github.com/somleng/sms-gateway","last_synced_at":"2026-03-04T09:02:34.800Z","repository":{"id":64489345,"uuid":"556718928","full_name":"somleng/sms-gateway","owner":"somleng","description":"Connect Somleng to your own SMS Gateway","archived":false,"fork":false,"pushed_at":"2026-02-24T20:56:20.000Z","size":5652,"stargazers_count":12,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-25T00:54:45.489Z","etag":null,"topics":["goip","goip-gsm-gateway","smpp","sms","somleng","text-message"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/somleng.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-10-24T11:39:22.000Z","updated_at":"2026-02-24T20:56:24.000Z","dependencies_parsed_at":"2024-03-04T21:38:12.482Z","dependency_job_id":"efcbd982-afa0-467d-becf-d6a50e4544d6","html_url":"https://github.com/somleng/sms-gateway","commit_stats":null,"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"purl":"pkg:github/somleng/sms-gateway","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somleng%2Fsms-gateway","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somleng%2Fsms-gateway/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somleng%2Fsms-gateway/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somleng%2Fsms-gateway/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/somleng","download_url":"https://codeload.github.com/somleng/sms-gateway/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/somleng%2Fsms-gateway/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30076935,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T08:01:56.766Z","status":"ssl_error","status_checked_at":"2026-03-04T08:00:42.919Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["goip","goip-gsm-gateway","smpp","sms","somleng","text-message"],"created_at":"2026-03-04T09:02:32.416Z","updated_at":"2026-03-04T09:02:34.793Z","avatar_url":"https://github.com/somleng.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Somleng SMS Gateway\n\n[![GitHub Action](https://github.com/somleng/sms-gateway/actions/workflows/build.yml/badge.svg)](https://github.com/somleng/sms-gateway/actions)\n\nSomleng SMS Gateway (part of [The Somleng Project](https://github.com/somleng/somleng-project)) is used to set up your own on-premise SMS gateway system and connect it to Somleng. This will give you the ability to take full control of your SMS infrastructure.\n\n![Somleng SMS Gateway](assets/diagram.png)\n\n## Download and Install the SMS Gateway\n\n### Docker (Recommended for most users)\n\n```sh\ndocker pull somleng/sms-gateway\n```\n\n### Downloading a pre-built binary\n\nDownload the [latest release](https://github.com/somleng/sms-gateway/releases) for your operating system. Note that currently we only have pre-built binaries for Linux.\n\n## Building from source\n\nThis will build a new single executable application binary for your OS.\n\n```sh\nnpm run dist\n```\n\n## Usage\n\n### Synopsis\n\n```sh\nUsage: somleng-sms-gateway [options] [command]\n\nOptions:\n  -k, --key \u003cvalue\u003e               Device key\n  -d, --domain \u003cvalue\u003e            Somleng Domain (default: \"wss://app.somleng.org\")\n  -p, --http-server-port \u003cvalue\u003e  HTTP Server Port (default: \"3210\")\n  -e, --environment \u003cvalue\u003e       Environment (production or development) (default: \"development\")\n  -v, --verbose                   Output extra debugging\n  -h, --help                      display help for command\n\nCommands:\n  goip [options]                  connect to GoIP Gateway\n  smpp [options]                  connect to SMPP Gateway\n  dummy                           connect to dummy Gateway\n  help [command]                  display help for commandd\n```\n\nThe application supports a number of connection modes including:\n\n* [SMPP](#smpp)\n* [GoIP (GSM Gateway)](#goip-gsm-gateway)\n* [Dummy](#dummy)\n\n### Running with Docker\n\n```sh\ndocker run -p 3210:3210 somleng/sms-gateway somleng-sms-gateway [options] [command]\n```\n\n### Web Interface\n\nThe Web interface displays connection information and configuration parameters. By default, it's available\nat [http://localhost:3210](http://localhost:3210).\n\n![SMPP Gateway Web Interface](assets/sms_gateway_connection_status.png)\n\n### Connection Modes\n\nThe documentation for running the SMS Gateway for each connection mode can be found below.\n\n#### SMPP\n\nThe SMPP connection mode is used to connect to a single SMPP server.\n\n```sh\nUsage: somleng-sms-gateway smpp [options]\n\nconnect to SMPP Gateway\n\nOptions:\n  --smpp-host \u003cvalue\u003e       SMPP host\n  --smpp-port \u003cvalue\u003e       SMPP port (default: \"2775\")\n  --smpp-system-id \u003cvalue\u003e  SMPP System ID\n  --smpp-password \u003cvalue\u003e   SMPP password\n  -h, --help                display help for command\n```\n\n#### GoIP (GSM Gateway)\n\nThe GoIP connection mode is used to connect to a [GoIP GSM Gateway](https://en.wikipedia.org/wiki/GoIP)\n\n##### GSM Gateway Configuration\n\nUsing the GoIP GSM Gateway web portal, configure the following:\n\nUnder **Configurations** -\u003e **Preferences**:\n\n1. Set SMPP SMSC to **Enable**\n2. Fill in **ID** with an SMPP system ID\n3. Fill in **Password** with an SMPP password\n4. Fill in **Port** with an SMPP port\n5. Set Channel number to **Enable**\n6. Set ENROUTE status to **Enable**\n\n![GoIP Configuration Preferences](assets/goip-sms-1_configurations_preferences.png)\n\nUnder **Configurations** -\u003e **SIM**:\n\n1. Set **Try to Get SIM Number from SIM Card** to **Disable**\n2. For each channel on your gateway, enter the phone number for the SIM card in E.164 format.\n\n*Note: We recommend that you manually configure the phone numbers for each SIM in your gateway to ensure\nthe format is in E.164. These numbers must exactly match the phone numbers that you configure on the [Somleng Dashboard](https://www.somleng.org/docs.html#sms_gateway_configuration_guide_create_phone_number).*\n\n![GoIP Configuration SIM](assets/goip-sms-2_configurations_sim.png)\n\n##### Start the SMS Gateway\n\nStart the SMS Gateway in GoIP mode, ensuring that the configuration parameters match what you configured above.\n\n```sh\nUsage: somleng-sms-gateway goip [options]\n\nconnect to GoIP Gateway\n\nOptions:\n  --goip-smpp-host \u003cvalue\u003e       SMPP host\n  --goip-smpp-port \u003cvalue\u003e       SMPP port (default: \"2775\")\n  --goip-smpp-system-id \u003cvalue\u003e  SMPP System ID\n  --goip-smpp-password \u003cvalue\u003e   SMPP password\n  --goip-channels \u003cvalue\u003e        Number of channels\n  -h, --help                     display help for command\n```\n\n#### Dummy\n\nThe Dummy connection mode is used to test the connection between the SMS Gateway and Somleng.\nOutbound messages are simply output to stdout.\n\n```sh\nUsage: somleng-sms-gateway dummy [options]\n\nconnect to dummy Gateway\n\nOptions:\n  -h, --help  display help for command\n```\n\n## License\n\nThe software is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsomleng%2Fsms-gateway","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsomleng%2Fsms-gateway","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsomleng%2Fsms-gateway/lists"}