website logo
Create accountLogin
Home
DCS
Node
Resources
Help center
Navigate through spaces
Home
DCS
Node
Resources
Help center
⌘K
Storj DCS
Get Started
AWS CLI and Hosted Gateway MT
AWS SDK and Hosted Gateway MT
Uplink CLI
Satellite Admin Console
Object Browser
Downloads
Download Uplink CLI
Download Self-hosted S3 Compatible Gateway
Download Storj Client Libraries
SDKs & Reference
Tutorial
How-to Guides
Concepts
Support
Support Overview
FAQ
Community Forum
Status Page
Help Desk
Billing, Payment & Accounts
Resources
Moved Documents
Docs powered by archbee 
30min

Cyberduck

Introduction

Cyberduck is a free open-source libre server - a small server system which enables you to run your own internet services independently - cloud storage browser for macOS, Windows and Linux that supports FTP and SFTP, WebDAV, and cloud storage such as Storj DCS and other cloud storage providers.

Users can leverage the Cyberduck services via the user interface (GUI) or CLI (for Linux), including file transfer by drag and drop and notifications via Growl. It is also able to open some files in external text editors.

Users can choose Storj DCS to act as a decentralized cloud storage network target to send files to via the Cyberduck file manager interface, available via Storj's hosted multitenant gateway (Quickstart - AWS CLI and Hosted Gateway MT) that is backward compatible with S3. This means you’ll be able to integrate with the Storj network via HTTP, and you won’t have to run anything extra on your end.

In this brief tutorial, we'll go over downloading and setting up Cyberduck to integrate with Storj DCS, facilitating easy and intuitive drag-and-drop file transfer to Storj DCS.

Downloading Cyberduck

As a free solution, Cyberduck gives users the freedom to run, copy, distribute, study, change and improve the software. Those who wish to pay for Cyberduck will receive a registration key as a contributor. Becoming a contributor registers the installed application to your name, disabling donation prompts after downloading or updating.

As noted, Cyberduck supports Windows, macOS as well as Linux. Users can download Cyberduck by navigating to https://cyberduck.io/download/. Here, you can download the given installer for both Windows and macOS.

For those who wish to download via CLI:

Windows

GUI
CLI
Terminal
|

Requires Chocolatey. See other installation options to download the MSI installer for Windows.

macOS

Terminal
|

Requires Homebrew. See other installation options to download an OS X installer package.

Linux

RPM Package

Terminal
|

Requires Yum Package Manager. See other installation options to download DEB and RPM packages.

DEB Package

Terminal
|

Requires APT. See other installation options to download DEB and RPM packages.

Using CyberDuck with Storj - Windows

Once the download is complete you'll be able to open the CyberDuck client. By selecting Open Connection to the top left, you’ll be able to establish a connection via Cyberduck. By selecting Amazon S3 from the dropdown, you’ll be prompted to fill out the following:

  • Server:
  • Port:
  • Access Key ID:
  • Secret Access Key:
Document image

To configure Storj DCS as the decentralized cloud storage network target you’ll need to generate Storj credentials.

Using CyberDuck with Storj - macOS

Once the download is complete you'll be able to open the CyberDuck client. By selecting the + button in the bottom left-hand corner of the client, you'll be able to add a connection bookmark, facilitating the connection between CyberDuck and Storj DCS. Select Storj DCS from the drop-down.

Document image

This is where you will add Server, Access Key ID, and the Secret Access Key for Storj Gateway MT.

Document image

To configure Storj DCS as the decentralized cloud storage network target you’ll need to generate Storj credentials.

Generate Credentials to the Gateway MT

One of the most versatile ways to get up and running with Storj DCS is through the Self-hosted S3 Compatible Gateway.

Gateway MT offers the following:

  • Encryption, erasure coding, and upload to nodes occur server-side
  • Supports parallelism for upload and multi transfer for download
  • 1GB upload will result in 1GB of data being uploaded to storage nodes across the network
  • Based on S3 standard

Navigate to the Access Management page within your project and then click on Create Access Grant. A modal window will pop up where you should enter a name for this access grant.

Document image

Assign the permissions you want this access grant to have, then click on Continue in Browser:

Document image

If you do not feel comfortable entering this sensitive information into your browser, we understand. Storj does not know or store your encryption passphrase. However, if you are still reluctant to enter your passphrase into our web application, please select “Continue in CLI” and follow these instructions instead.

Document image

Generate and Save the Encryption Passphrase. If this is your first access grant, we strongly encourage you to use a mnemonic phrase as your encryption passphrase (The GUI automatically generates one on the client-side for you if you choose "Generate Phrase.") You will need this passphrase later if you want to again access files uploaded with this encryption phrase.

Document image

Be sure to download the Access Grant to save it and then click on the Generate S3 Gateway Credentials link.

Document image

Now click on the Generate Credentials button.

Document image

Copy your Access Key, ** _Secret Key, and ** **Endpoint**_ to a safe location.

Configuring Storj + Cyberduck

Whether using Windows or macOS, you’ll simply add the Storj Gateway S3 credentials into the CyberDuck client to establish the connection. Click the Open Connection button to create a new connection.

  • First start by selecting S3 from the drop-down menu
  • Enter your S3 Gateway Credentials Endpoint for the Server selection (without )
  • Enter your S3 Gateway Credentials Access Key into the Access Key ID selection
  • Enter your S3 Gateway Credentials Secret Key into the Secret Access Key selection
Document image

Click Connect

Use endpoint without , i.e. gateway.us1.storjshare.io in the Cyberduck Server entry above, otherwise Cyberduck will revert to WEBDAV (HTTPS) causing a connection error.

As seen here:

Document image





For Mac OS

Back to the open connection in Cyberduck as we referenced above in Using CyberDuck with Storj - macOS you now have all the information you need to send files to your Storj DCS network.

  • select your saved bookmark Here, you'll see the Amazon S3 server window reopen. To move forward, you'll simply just add in your Storj Gateway S3 credentials that we previously configured.
  • Enter your S3 Gateway Credentials Endpoint for the Server selection
  • Enter your S3 Gateway Credentials Access Key into the Access Key ID selection
  • Enter your S3 Gateway Credentials Secret Key into the Secret Access Key selection

Close the modal window and click the modified bookmark.

If you’ve added in your S3 Gateway Credentials properly, you’ll see your Storj DCS buckets and you can now drag and drop files to your Storj DCS network seamlessly and easily via the Cyberduck GUI. Congrats!

Updated 29 Jan 2023
Did this page help you?
Yes
No
UP NEXT
Dataverse
Docs powered by archbee 
TABLE OF CONTENTS
Introduction
Downloading Cyberduck
Windows
macOS
Linux
Using CyberDuck with Storj - Windows
Using CyberDuck with Storj - macOS
Generate Credentials to the Gateway MT
Configuring Storj + Cyberduck
For Mac OS