{"id":33228790,"url":"https://github.com/thoreinstein/serverless-offline-ssm","last_synced_at":"2026-02-07T16:34:18.841Z","repository":{"id":29613285,"uuid":"122198175","full_name":"thoreinstein/serverless-offline-ssm","owner":"thoreinstein","description":"Read SSM parameters from a .env file instead of AWS","archived":false,"fork":false,"pushed_at":"2026-01-21T23:45:26.000Z","size":672,"stargazers_count":95,"open_issues_count":22,"forks_count":24,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-01-26T22:31:06.069Z","etag":null,"topics":["aws","lambda","serverless","serverless-framework"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/thoreinstein.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-02-20T12:56:17.000Z","updated_at":"2025-07-16T01:48:23.000Z","dependencies_parsed_at":"2024-01-03T02:24:52.394Z","dependency_job_id":"cfb7a4c0-14c4-4fa4-afbd-e528c8566ccc","html_url":"https://github.com/thoreinstein/serverless-offline-ssm","commit_stats":null,"previous_names":["janders223/serverless-offline-ssm"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/thoreinstein/serverless-offline-ssm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoreinstein%2Fserverless-offline-ssm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoreinstein%2Fserverless-offline-ssm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoreinstein%2Fserverless-offline-ssm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoreinstein%2Fserverless-offline-ssm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thoreinstein","download_url":"https://codeload.github.com/thoreinstein/serverless-offline-ssm/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoreinstein%2Fserverless-offline-ssm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29199852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T16:28:23.579Z","status":"ssl_error","status_checked_at":"2026-02-07T16:28:22.566Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["aws","lambda","serverless","serverless-framework"],"created_at":"2025-11-16T17:00:34.127Z","updated_at":"2026-02-07T16:34:18.836Z","avatar_url":"https://github.com/thoreinstein.png","language":"TypeScript","funding_links":[],"categories":["Serverless Framework Plugins"],"sub_categories":[],"readme":"# serverless-offline-ssm\n\nThis [Serverless](https://github.com/serverless/serverless) plugin allows you to develop offline while using AWS SSM parameters in your `serverless.yml` template. The plugin looks for environment variables which are fulfilled by SSM parameters at build time and substitutes them from a `.env` file when running locally with the [serverless-offline plugin](https://github.com/dherault/serverless-offline).\n\n## NOTE!!\n\nVersion `6.x` only works with `Serverless 3+`. Version `5.X` only works `Serverless 1.69+`, if you'd like to use this\nplugin with `Serverless \u003c= 1.59` use version `4.1.2`\n\n## Documentation\n\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Installation\n\nFirst install the plugins using npm or yarn\n\n```bash\nnpm install serverless-offline serverless-offline-ssm --save-dev\n\n#or\n\nyarn add -D serverless-offline serverless-offline-ssm\n```\n\nThen inside of your project's `serverless.yml` file add the following to the plugins section. Note it is important that `serverless-offline-ssm` is loaded before `serverless-offline`. This is important to ensure that we are setting the variables properly for `serverless-offline` before it needs them.\n\n_NOTE:_ It is imperative that `serverless-offline-ssm` be the the first plugin listed in the plugins section of your `serverless.yml` file. Due to the load order of plugins, other plugins may interfere with the loading of your `.env` file.\n\n```yaml\nplugins:\n    - serverless-offline-ssm\n    - serverless-offline\n```\n\n## Configuration\n\nYou can choose to use a `.env` file and/or define your variables in\n`serverless.yml`. Variables within `serverless-offline-ssm` take precedence.\n`serverless-offline-ssm` will always check if the section `custom.serverless-offline-ssm`\nhave any values, if not it will fallback to `.env`\n\n### Stages\n\nThis plugin executes if the stage defined within the plugin options\nor provider sections of your `serverless.yaml` are includes within the\n`stages` property of the plugin configuration. If this condition has not been\nmet the plugin has no effect.\n\nThe `stages` property of the plugin configuration can be overridden with a\ncli parameter `--ssmOfflineStages` which takes a comma separated list of\nstages.\n\n### .env\n\nYour `.env` file needs to contain only variable names without the `ssm:` prefix and `~(true|false|split)` sulfix.\n\nIf you've defined `${ssm:lambda.LAMBDA_NAME.DB_DSN~true}` in `serverless.yml` file your `.env` need to be like the example bellow:\n\n```\nlambda.LAMBDA_NAME.DB_DSN=\"VAR VALUE\"\n```\n\n### serverless.yml\n\n```yaml\nprovider:\n  stage: offline\ncustom:\n  serverless-offline-ssm:\n    stages:\n      - offline\n    ssm:\n      'lambda.LAMBDA_NAME.DB_DSN': 'sample-value-goes-here'\n      'another.sample.value': '99 red baloons'\n```\n\n## Contributing\n\nPull requests are always welcome. Please see the [contributing](https://github.com/janders223/serverless-offline-ssm/blob/master/CONTRIBUTING.md) guidelines.\n\n## License\n\n[MIT](https://github.com/janders223/serverless-offline-ssm/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoreinstein%2Fserverless-offline-ssm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthoreinstein%2Fserverless-offline-ssm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoreinstein%2Fserverless-offline-ssm/lists"}