Skip to main content

Docker Success Center

The Docker enterprise customer portal.

Docker, Inc.

What does "blob upload unknown" mean when pushing to a HA DTR?

Introductory Paragraph: What does "blob upload unknown" mean when pushing to a HA DTR?


The error "blob upload unknown", that typically means an attempt was made to push a docker image to an HA DTR installation, where the backend storage has not been configured for replication.  This is typically an oversight during installation where the local filesystem is being used for storage, but something like NFS isn't backing the storage. Switching to a replicated storage option solves this.

If NFS mounts for all DTR replicas have been configured and the error persists, it may be because of the NFS server side settings do not meeting the requirements for NFS when in use with the registry.  The required NFS server options are: sync and actimeo=0.  This will ensure the writes occur from one replica and are immediately available on others.  

If using the AWS Quickstart Template an S3 bucket will already be created, but requires configuring DTR to use it:

  • In DTR, go to Settings > Storage.  Change the storage to S3.  Set region to "AWS region name" set "S3 bucket name".  The S3 bucket is already created; may find this in the CloudFormation Stack's Outputs tab.  The Key is 'S3Bucket' and the IAM role should already be setup.  

  • The Access Key and Secret Key get passed automatically. The root directory can be left blank to use the default root.  

  • After configuring DTR with S3, the ability to push and pull images is enabled, with them being stored in S3.

  • Was this article helpful?