Getting Started

Orchesto is a multi-point object storage gateway compatible with the Amazon S3 API.


1. Start the service

To use Orchesto the first time, you need to explicitly accept the End-User License Agreement (EULA) by setting the ACCEPT_EULA environment variable to Y. Then, start Orchesto like so:


2. Setup using the browser

Go to the management console in your web browser:

Replace with the IP address that works for you.

Getting Started

The first time you visit the management console, you see the welcome page with the admin access keys. This security credential allows you to use and manage the Orchesto object storage service, as well as create new security credentials.

Welcome - Admin Credentials

Make sure you store the admin access keys in a secure location. Then, select Continue to access the dashboard.

The dashboard shows the current status of the server and connected storage providers. Select Add backend to connect a new storage provider.

Add Backend

On the left-hand side of the management console is the sidebar, which provides access to all principle management functions such as the dashboard.


Access the object browser by selecting Buckets in the sidebar. Then, to make all buckets you access in the storage provider available through Orchesto, select Add Virtual Bucket and choose Add All under the Backing Bucket input field.

Add All Buckets

You can connect to any number of storage providers and make any combination of buckets available through the gateway.

Using Orchesto

Orchesto is compatible with the Amazon S3 API, so you can use any Amazon S3 compatible client to upload and download data. Configure the client with the object storage endpoint and credentials to get started.

The object storage endpoint is the same as the management console in your web browser:

For example, the AWS Command Line Interface (CLI) can be configured with your Orchesto credentials like so:

$ aws configure
AWS Secret Access Key [None]: KTRUdnMAskpCc7ph/8Om0muMYYcRcxT4H7Kel3ZU
Default region name [None]:
Default output format [None]:

Then, include the object storage endpoint via the --endpoint-url option when you use the AWS CLI.

$ aws s3 ls --endpoint-url
2018-05-17 10:14:27 acropolitan
2018-05-17 10:14:32 concretely
2018-05-17 10:14:32 confabulate
2018-05-17 10:14:31 cylindrocellular
2018-05-17 10:14:27 debasingly
2018-05-17 10:14:28 distinctiveness
2018-05-17 10:14:31 huari
2018-05-17 10:14:31 inexactitude
2018-05-17 10:14:33 nonbotanical
2018-05-17 10:14:31 olefinic
2018-05-17 10:14:32 overbulk
2018-05-17 10:14:27 poligraphical
2018-05-17 10:14:31 polyopic
2018-05-17 10:14:31 potful
2018-05-17 10:14:33 rutherfordite
2018-05-17 10:14:27 sportsmanlike
2018-05-17 10:14:27 suprachorioidal
2018-05-17 10:14:32 unsymbolically