Difference between revisions of "Pro:S3 Provider Configuration"

From FileZilla Wiki
Jump to navigationJump to search
m (Reverted edits by 2600:387:2:803:0:0:0:72 (talk) to last revision by 2A02:CB80:4241:8887:6186:68E1:2660:54CB)
Tag: Rollback
 
(6 intermediate revisions by 4 users not shown)
Line 6: Line 6:
  
 
FileZilla Pro uses this configuration to resolve a host name configured in the site manager to a specific provider.
 
FileZilla Pro uses this configuration to resolve a host name configured in the site manager to a specific provider.
 
  
 
= Step by Step instructions =
 
= Step by Step instructions =
  
 
# Start FileZilla and choose Edit, Settings, S3: Providers:
 
# 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.
+
# In the Provider list click New to add a new provider
 
#:[[File:Pro_digital_ocean_1.png]]
 
#:[[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.  
+
# 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.
 
#:[[File:Pro_digital_ocean_2.png]]
 
#:[[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.
 
# 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.

Latest revision as of 08:47, 12 October 2023

Introduction[edit]

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[edit]

  1. Start FileZilla and choose Edit, Settings, S3: Providers:
  2. In the Provider list click New to add a new provider
    Pro digital ocean 1.png
  3. 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.
    Pro digital ocean 2.png
  4. 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.
    Pro digital ocean 3.png
  5. In Site Manager add a new site:
  6. In Host enter the address of your space
  7. In Access Key ID enter your space access key
  8. In Secret Access Key enter your space access secret
    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.