Skip to main content

Allows storing Docker registry credentials using AWS SecretsManager

Project description


This helper is suitable for storing Docker registry credentials for distributed Docker installations across AWS EC2 clouds. It stores all necessary information in JSON in single secret managed by AWS SecretsManager service.


The only required software is boto3


Install package using pip

pip install docker-credential-aws-sm


There are 3 steps required before you can use the helper in the cloud

  1. To register helper for current user edit $HOME/.docker.config.json and place configuration required configuration:
  "credStore": "aws-sm"

For automatic repository discovery configuration should also contain "HttpHeaders" key:

  "credStore": "aws-sm",
  "HttpHeaders": {
    "User-Agent": "Docker-Client/18.09.1 (linux)"
  1. Export necessary environmental variables. DOCKER_SECRETSMANAGER_NAME is mandatory, AWS_ variables should be set according to needs:
# (required) DOCKER_SECRETSMANAGER_NAME points the secret name under which the tool stores credentials
export DOCKER_SECRETSMANAGER_NAME='my_docker_sercret'
# (optional)
export AWS_...
  1. Create IAM user or role according to your need.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for docker-credential-aws-sm, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size docker_credential_aws_sm-0.1-py2-none-any.whl (4.8 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size docker-credential-aws-sm-0.1.tar.gz (3.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page