Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

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

This version
History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
docker_credential_aws_sm-0.1-py2-none-any.whl (4.8 kB) Copy SHA256 hash SHA256 Wheel py2
docker-credential-aws-sm-0.1.tar.gz (3.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page