Skip to main content

S3 proxy plugin for AWS CLI

Project description


This awscli plugin allows usage of proxy for S3 service stored in profile configuration.


The easiest way to install awscli-plugin-s3-proxy is to use `pip`:

$ pip install awscli-plugin-s3-proxy

You can also install the latest package from GitHub source which can contain changes not yet pushed to PyPI:

$ pip install git+

or, if you install `awscli` via Homebrew, which bundles its own python, install as following:

$ /usr/local/opt/awscli/libexec/bin/pip install awscli-plugin-s3-proxy

Getting Started

Before using awscli-plugin-s3-proxy plugin, you need to [configure awscli]( first.

**MUST**: Once that's done, to enable `awscli-plugin-s3-proxy` plugin, you can run:

$ aws configure set plugins.s3-proxy awscli_plugin_s3_proxy

The above command adds below section to your aws config file. You can also directly edit your `~/.aws/config` with below configuration.

s3-proxy = awscli_plugin_s3_proxy

To add proxy configure to a profile (assuming you have a **test** profile), you can run:

$ aws configure --profile test set s3.proxy

The above command adds below section to your profile:

[profile test]
s3 =
proxy =

Now you can access S3 using proxy with profile:

$ aws s3 ls --profile test

If You want to use profile without passing it every time as parameter, use environment variable, ex:

export AWS_PROFILE=test

Alternative (classic) method
You can follow the [guide by AWS]( which describes how to use proxy using system environment variables. Here is the example:

export http_proxy=
export https_proxy=
export HTTP_PROXY=

Remember that after setting these variables, `ALL` awscli requests will be going through proxy!

Additionally, if You are using awscli on EC2 host, add `NO_PROXY` variable to allow awscli communicate with metadata endpoint:


Project details

Download files

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

Files for awscli-plugin-s3-proxy, version 0.2
Filename, size File type Python version Upload date Hashes
Filename, size awscli_plugin_s3_proxy-0.2-py2-none-any.whl (2.8 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size awscli_plugin_s3_proxy-0.2-py3-none-any.whl (2.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size awscli-plugin-s3-proxy-0.2.tar.gz (2.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page