Editing Pro:S3 Provider Configuration

= Introduction =

This guide explains how to configure FileZilla Pro to connect any Amazon S3 compatible cloud provider.

In this guide you'll see the configuration for Digital Ocean provider as an example. However these instructions work also for any compatible provider.

FileZilla Pro uses this configuration to resolve a host name configured in the site manager to a specific provider.

= Step by Step instructions =

# Start FileZilla and choose Edit, Settings, S3: Providers:
# In the Provider list click Add to add a new provider. If you are using the same version of FZPro that I am, on Windows 10, this is as far as you will get. You will not be able to save the new provider. You will flounder and nothing will get accomplished.
#:[[File:Pro_digital_ocean_1.png]]
# In the Regions list you add the regions. This information can be obtained from your provider. For each region there is a name, a description and a list of endpoints separated by semicolon. FileZilla Pro will use these endpoints to match the host with a specific region. If you are using the same setup that I am, none of this will work. You will enter, for example, "nyc3" and that is all you will be able to do. Nothing you try will allow you to advance to the description or endpoint fields. You will try, and try, and try. You will look in vain, wasting a lot of time, for documentation about how to make this work, but there apparently is none. You will, at this point, give up in disgust, it now being obvious that you have wasted $20 and the free edition would have been adequate. 
#:[[File:Pro_digital_ocean_2.png]]
# Catch All is used to handle redirects to regions not yet known as when the provider adds a new region. Format is used to build endpoints for unknown regions. Format accepts the following tags {REGION} and {BUCKET}. Those tags are replaced by region and bucket respectively.
#:[[File:Pro_digital_ocean_3.png]]
# In Site Manager add a new site:
# In Host enter the address of your space
# In Access Key ID enter your space access key
# In Secret Access Key enter your space access secret
#:[[File:Pro_digital_ocean_4.png]]

When establishing a session with FileZilla, the correct provider and region is fetched from the list providers as follows, top to bottom:

* If the hostname ends on a known endpoint, the matching region and associated provider is used;
* Otherwise if it matches a catch-all, the associated provider is used, assume us-east-1;
* Otherwise fall back to the first configured provider (by default that's Amazon) and assume us-east-1

For further instructions how to use FileZilla please refer to our [[Tutorial]].