Skip to main content
Version: v1.17.0

Amazon S3

Zed tools can access Amazon S3 and S3-compatible storage via s3:// URIs. Details are described below.

Region​

You must specify an AWS region via one of the following:

  • The AWS_REGION environment variable
  • The ~/.aws/config file
  • The file specified by the AWS_CONFIG_FILE environment variable

You can create ~/.aws/config by installing the AWS CLI and running aws configure.

Note

If using S3-compatible storage that does not recognize the concept of regions, a region must still be specified, e.g., by providing a dummy value for AWS_REGION.

Credentials​

You must specify AWS credentials via one of the following:

  • The AWS_ACCESS_KEY_ID andAWS_SECRET_ACCESS_KEY environment variables
  • The ~/.aws/credentials file
  • The file specified by the AWS_SHARED_CREDENTIALS_FILE environment variable

You can create ~/.aws/credentials by installing the AWS CLI and running aws configure.

Endpoint​

To use S3-compatible storage not provided by AWS, set the AWS_S3_ENDPOINT environment variable to the hostname or URI of the provider.

Wildcard Support​

Like the AWS CLI tools themselves, Zed does not currently expand UNIX-style * wildcards in S3 URIs. If you find this limitation is impacting your workflow, please add your use case details as a comment in issue zed/1994 to help us track the priority of possible enhancements in this area.