Amazon S3

Automatically upload language files to an S3 bucket of your choice upon export.

Nick Ustinov avatar
Written by Nick Ustinov
Updated over a week ago

This feature is available starting from the Pro plan.

Use this app to serve static content including your language files from an Amazon S3 bucket.

Prerequisites

First of all, you'll need to generate Amazon S3 access and secret keys. We highly recommend creating a separate key pair for this app. You can use the Amazon IAM service to do this. The required rights are:

  • s3:ListBucket

  • s3:PutObject

  • s3:PutObjectAcl (the latter is required as Lokalise changes the ACL of the uploaded object to public-read).

Also you'll have to create an S3 bucket where your translation files should be uploaded to.

Setup

Open your Lokalise project and proceed to Apps:

Find Amazon S3 in the list, click on it and then press Install.

You'll need to specify the Access key ID, Secret access key and the Bucket name:

Optionally, adjust the region, change the access control list settings, and add a directory prefix.

Once you are ready, click Save configuration.

Usage

Once the app is set up, you can trigger it with each file export. 

Web dashboard

Proceed to the Download page and enable the Amazon S3 checkbox in the App triggers section:

Then simply click Build and download or Build only.


CLI tool

A CLI version 0.47 or higher is required to use this app. Provide the --triggers=amazons3 parameter when running the file download command.


API

Add the 'amazons3' option to the triggers param when sending the Download files request. Please note that we can export content of any project branch using this endpoint.

Did this answer your question?