Media Traffic Isolation

Disclaimer : This documentation is provided solely as an example. It explains how to set up your Shotgun Isolation environment so that it can be connected to Shotgun cloud infrastructure. Please adapt it to your studio security requirements as needed. As Shotgun has no visibility on your AWS Account, ensuring that this account is secure is a client responsibility.

The media traffic isolation allows your users to access your media in your AWS S3 bucket privately (not transiting on the public internet).

Media Isolation activation is a pre-requisite to enable this feature. If you didn’t do so already, see Media Isolation

Set up a VPC with private subnets in your S3 bucket AWS region

You will need to deploy a private VPC with the required VPC endpoints. We provide a private VPC CloudFormation template as a starting point. The template creates a VPC with 2 private subnets and the required VPC endpoints.

  • Go the CloudFormation service in AWS Console
  • Select Template is ready
  • Set Amazon S3 URL to
  • Next
  • Set a stack name like shotgun-vpc
  • Set your S3 bucket name
  • Next
  • Next

Set up access from your site network to your AWS VPC

Options provided by AWS:

Note : If Direct Connect is chosen, we recommend testing it with a simpler/faster solution first to validate the setup. You can then replace that solution with Direct Connect once the setup is complete.

Add an S3 endpoint to your VPC if you didn’t use the CloudFormation template.

Add endpoint Add endpoint Add endpoint

Set up S3 proxy

You will need to deploy an S3 proxy in your VPC to proxy the traffic from your network into the S3 VPC endpoint. We provide an S3 proxy CloudFormatiom Template as a starting point. This will create an ECS Cluster and an ECS service to run the S3 proxy on AWS Fargate behind an AWS ALB.

Upload the Docker image to a private AWS Docker repositoty

Create an AWS ECR Repository named s3-proxy.

Upload the s3-proxy Docker image to your ECR repository.

  • You will need to install Docker on your workstation then run the following commands.
  • Do the docker login using instructions in your AWS Console View push commands button.

You will need to change the ECR repository URL to match yours.

docker pull
docker tag
docker push

Create CloudFormation stack

Create a new stack in AWS Console using the S3 proxy CloudFormatiom Template.

  • Go the CloudFormation service in AWS Console
  • Select Template is ready
  • Set Amazon S3 URL to
  • Next
  • Set a stack name like shotgun-s3-proxy
  • Set all the parameters with no default value
  • Next
  • Accept I acknowledge that AWS CloudFormation might create IAM resources
  • Next

Configure HTTPS

Shotgun only support https S3 proxy. You will need to configure https support on the AWS ALB.

  • First add a DNS Entry in your domain to access the S3 proxy. ie:
  • Get a SSL certificate for your url, we recommend using AWS Certificate Manager.
  • Configure the HTTPS support on the S3 proxy by adding a new HTTPS listener on the AWS load balancer.


Test the S3 proxy

Try to access your S3 proxy using the ping route. ie:

Configure your test site to use your S3 proxy.

Go in your test site Preferences menu and set S3 Proxy Host Address to the S3 proxy url. ie: Check if you call still access and upload new media.

Next Steps

See Web Traffic Isolation to activate the Web Traffic Isolation feature.

See Media Replication to activate the Web Traffic Isolation feature.

Go to Setup for an overview of the possible next steps.

Edit this document