Amazon S3 setup for ShareX

Using Amazon S3 with ShareX: A Configuration Guide

Obtain an AWS account

Create a Policy

To improve security, we will create a policy that grants only the necessary permissions for file uploads.

Open policies page
Press Create policy
Click Service, type S3, then selectS3
Click Actions, type PutObject, and choose bothPutObject and PutObjectAcl
Click Resources, make sure Specificis marked, then click theAdd ARN link
Select Anyto enable access to all your buckets

Note:You can deselectAnylater if you prefer to specify a particular bucket name.

Select Any for the object name as well
Press Add in the Add ARN(s) dialog
Press Review policy
Assign a name to the policy, such as,ShareX_PutObject
Press Create policy

Make a Group

Open groups page
Press Create New Group
Provide a name for the group; "ShareXUploadGroup" is an example.ShareX
Press Next Step
Click Policy TypeFilter using the dropdown and chooseCustomer Managed
Check the box next to your newly created policy, which should be namedShareX_PutObjectif you followed the naming suggestion.
Press Next Step
Press Create Group

Create user

Open users page
Press Add user
Enter the desired username.
In the access type section, check the box forProgrammatic access
Click Next: Permissions
Tick the checkbox for your recently created group, likely namedShareXif you used the suggested name.
Press Next: Tags
Press Next: Review
Press Create user

Important:On this page, either note downAccess key ID and Secret access keyfor safekeeping or clickDownload .csvto download them as a file. These credentials will be needed in ShareX later.

Press Close

Account Security (Optional)

While not mandatory, these steps are recommended to help secure your account.

Open Identity and Access Management page (Dashboard)
Ensure that all security status indicators on this page are green.

It may be necessary to enable multi-factor authentication and set up a strong password policy.

Create an S3 Bucket

Your uploaded files will reside within this bucket.

Open S3 Management Console
Press Create bucket

Important:If you plan to use a custom domain with S3, the bucket name must match your CNAME. For example, if your desired URL ishttps://i.example.com/image.png, the bucket name should be i.example.com. More information can be found here.

Enter the desired bucket name.
Select the region where you want the bucket to be hosted.

Tip:This site offers a way to assess regional ping times:cloudping.info

To ensure uploaded files are publicly accessible via URL, verify that theBlock all public accessoption is not selected.
Press Create bucket

Optional: Custom Domain DNS Setup

DNS configuration is required if you plan to use your own domain.

Consider an example where you're usingCloudflare, your bucket is namedi.example.com, and it resides in theEU (Frankfurt)region. Your DNS settings would then be configured as follows:

Type: CNAME
Name: i
Target: i.example.com.s3.eu-central-1.amazonaws.com

A complete list of regional endpoints is available underShareX main window -> Destinations -> Destination settings -> Amazon S3 tab -> Endpoints.

The designated target should be{bucketname}.{endpoint}.

Additional details are available here.

ShareX Amazon S3 Settings Configuration

From the primary ShareX window, accessDestinations -> Destination settings
Select the Amazon S3 tab
Enter the Access key ID and Secret access keythat you recorded earlier.
In the endpoints section, select the same region chosen during bucket creation.
Enter the name of your created bucket.
For the upload path, we suggest using%y/%mo, which organizes uploads into subfolders like2020/04
If a custom domain is being used, check theUse custom domainoption and type it into the provided text box, for instance,https://i.example.com
You may now close the destination settings window.
Within the main window, ensure Amazon S3 is selected as the destination for image, text, and file uploads.

You are now prepared to useAmazon S3 in ShareX!