Couchdrop can be used for multiple scenarios, it can also be seen as a universal adapter to interact and access your backend cloud storage, whether this is through SFTP, FTP, S3, Web Portal or Couchdrop's API. The most common use case for Couchdrop is its use as a Cloud SFTP or Managed File Transfer platform.
Getting started with Couchdrop is simple and takes only a few minutes to get going. This guide will walk you through getting a basic SFTP solution up and running, as well point out any tips that may be of use.
In a rush? You can skip the first two steps and jump to the third and use the default configured Couchdrop hosted storage and your root admin user to connect.
Step 1. Configure your backend SFTP storage
So you have created an account with Couchdrop, what next? Couchdrop has provisioned you by default with hosted storage. If you wish to bring your own, you can connect your own third party storage such as SharePoint, Azure, Amazon S3, Google Drive, etc. Guides on how to connect third party storage can be located here.
If you want to configure your own storage see below, otherwise skip to Step 2.
- Navigate to the storage management tab within Couchdrop's product interface.
- At the top of the screen either select a storage icon or click the plus to add a storage endpoint that is not listed.
- Select your chosen storage endpoint from the dropdown, depending on what you choose different authentication options will appear. For this scenario we are using Couchdrop's provided hosted storage.
- You can select a region of choice for where the data will be stored. We also recommend changing the mount point to something recognisable, as this will be referenced when creating a user.
- When ready save storage.
- You now have storage configured to be used as the backend for your SFTP server, you will be taken back to your virtual file system where you can navigate into the storage and interact with the files, create folders, etc.
- We have created a folder called test under the Couchdrop hosted storage configured above.
Step 2. Configure SFTP users
To access the backend storage to upload, download or interact with the files you will need user accounts to log in via SFTP. These users can be restricted to certain IP addresses, folders and file operations. Additionally you can disable insecure protocols and access to the Couchdrop platform.
- Go to the user management tab within the Couchdrop product interface
- On the right of the screen click add user
- You are taken to a window where you configure your SFTP user, provide your SFTP user the following:
|Password or RSA Key||
As you scroll down further user configuration is available:
When you've configured your user as above, then save settings. You will be returned to your user dashboard where you can see your newly created user and some details.
Step 3. Connect via SFTP
You have now configured the backend storage where data will rest, and a user who will upload, download and interact with the files at rest. Next step is for the user to connect. To connect use your organisations primary Couchdrop subdomain, or create a CNAME record and point it to this. You can find your organisations sub-domain under the global settings.
- Example configuration using Cyberduck:
- Uploading a file via Cyberduck
- The file has arrived in Couchdrop under the /couchdrop/test folder as expected (for more information you can look at Couchdrop's audit log for more information)
- Web portal custom branding
- Restricting users to specific folders and directories
- Redirecting storage root directory
- Sharing files, folders and directories
- Secure upload portal