Setting up an S3 bucket (Legacy API Keys)
Learn how to set up a new or existing S3 bucket so that it can store PDFs generated by Paperplane.
Paperplane uploads PDFs to your own S3 bucket. In order for this to occur, you will need to grant permission to upload files to your bucket. This is done by setting a "bucket policy".
Follow the steps below to create your bucket and apply the policy. You can use the AWS web console or the command line interface.
Sign in to AWS and open the S3 console in your browser. Click “Create Bucket” and choose a bucket name and region. Continue to step through the wizard (you can leave all the default options unchanged) and create the bucket.
Next you’ll need to give Paperplane permission to upload to the bucket. To do this:
This quick video walks through the process:
Setting the bucket policy using the AWS web console
If you have the AWS CLI installed and set up, you can create and configure buckets from the command line. To create a bucket, run this command, substituting your preferred bucket name and AWS region:
$ aws s3 mb s3://myapp-bucket-name --region us-west-1
$ aws s3api put-bucket-policy --bucket myapp-bucket-name --policy file://path/to/policy.json
When applying the policy make sure to change
myapp-bucket-nameto the actual name of your bucket.
Your bucket is now ready for use!