Skip to main content

Using Cyberduck with CoreWeave AI Object Storage

How to manage CoreWeave AI Object Storage buckets and objects with Cyberduck

Cyberduck is a cloud storage browser that you can use to manage buckets and objects with AI Object Storage.

Prerequisites

Installation and configuration

  1. Open the Cyberduck application.

  2. Install the CoreWeave AI Object Storage connection profile:

    • In Cyberduck's menu bar, locate Connection Profiles:
      • For macOS: Cyberduck ▸ Settings ▸ Connection Profiles.
      • For Windows: Edit ▸ Preferences ▸ Connection Profiles
    • In the profiles gallery's search field, type "CoreWeave". Search results may take a few minutes to appear. You only need to complete this step once at initial setup.
    • Check the checkbox next to "CoreWeave AI Object Storage".
    • Close Preferences.

Connect to CoreWeave AI Object Storage

When you open a connection from Cyberduck to AI Object Storage, you have the option to save a bookmark for more convenient access, but it's not required.

Open a connection

  1. Click the Open Connection toolbar button (or File ▸ Open Connection).
  2. Enter your CoreWeave AI Object Storage Access Key and Secret.
    • For macOS: At the bottom left, the "Add to Keychain" checkbox is selected by default. Uncheck this option if you prefer to enter your secret each time.

The Cyberduck browser displays a root-level view showing all your buckets.

You can add a bookmark from your current connection.

Save a bookmark

Bookmarks allow you to save connection settings, like a default path. When you save a bookmark in Cyberduck, it remains in your main Cyberduck browser window, labeled with its nickname and your access key.

  1. In Cyberduck, open the Bookmark menu and select New Bookmark.
  2. Expand the dropdown menu at the top. Scroll to the bottom of the menu and select CoreWeave AI Object Storage.
  3. Give the connection a nickname.
  4. Optional: In macOS, you can create labels to organize and group your Cyberduck bookmarks.
  5. Enter your CoreWeave AI Object Storage Access Key and Secret.
  6. To bookmark your connection to a specific bucket, set your default path:
    • Expand More Options.
    • The Path field defaults to the root; append your bucket name. For example, /test-bucket.
  7. Close the bookmark dialog window. Cyberduck saves the bookmark and displays it in the browser window.
  8. Double-click your new bookmark. The Cyberduck browser reflects the path if you set one; otherwise it displays the root-level view of all your buckets.

Managing AI Object Storage resources

This section shows how to manage buckets and files in Cyberduck.

Create a new bucket in CoreWeave AI Object Storage

  1. Open your bookmark and make sure you are connected to AI Object Storage. The connection is successful if you see the bookmark name at the top of the window with your access key ID displayed below it, like [email protected]:

  2. Make sure no existing buckets are selected.

  3. Expand the Cyberduck browser window to view the Actions menu (gear icon). Expand this menu, and click New Folder. (Alternatively, use File > New Folder from the main menu, or right-click and select New Folder.)

  4. In the Create new folder dialog window, enter a name for your bucket and select the region.

  5. Click on the Create button to create the bucket.

    • If you're not prompted to select a region, you're creating a folder inside an existing bucket. Deselect any selected buckets before creating a new bucket.
Delay after bucket creation

Due to DNS caching, buckets created with Cyberduck may take several minutes to become available for use. Cyberduck may show an error if you try to use a bucket immediately after creating it: Region does not match. Please contact your web hosting service provider for assistance.

Wait a few minutes before adding folders or files to a bucket you just created.

Create a new folder

To create a new folder within a bucket:

  1. Select your bucket in the Cyberduck browser.

  2. Using the main Cyberduck menu, go to File > New Folder. (Alternatively, expand the Actions menu on the Cyberduck browser and click New Folder, or right-click and select New Folder.)

  3. Enter a name for the folder, and click Create:

If you're prompted to select a region, note that you're creating a new bucket. To create a new folder within an existing bucket, make sure your bucket is selected in the Cyberduck browser before you create the folder.

Upload files to the newly created bucket

  1. Open your file explorer and browse to the files you wish to upload.

  2. Select the files and drag them into the Cyberduck window; hover over the newly created bucket until it is highlighted, and then drop in the files.

  3. The Transfers window shows upload progress and status:

    It displays both the local file path and a path-style URL. The local path link opens the file in your file explorer. The path-style URL is not supported by AI Object Storage and will return an error.

Browsing and searching files

To browse files within a bucket:

  • In the root-level view, expand the carat next to the bucket name to view the subdirectories and objects.
  • Alternatively, double-click the bucket and the Cyberduck browser shows only items in that bucket.

To search files within a bucket:

  1. Double-click the bucket you want to search. You should now see a list of files in the bucket.
  2. Click the Search icon at the top of the Cyberduck browser.
  3. Type in the search term to find files by name. Click Search to confirm in the dialog window. After a few moments, the Cyberduck browser displays your search results.

Deleting resources

To delete files within a bucket:

  1. Click into the bucket in the Cyberduck browser.

  2. Select the files you wish to delete. Use command-click or right-click and select Delete.

  3. The dialog window lists the items you wish to delete. Click the Delete button to confirm:

If you're in the root view that shows all buckets, be careful not to select entire buckets when deleting multiple items.

To delete buckets:

  1. In the main Cyberduck browser, select the bucket(s) you want to delete.
  2. Command-click or right click and select Delete.
  3. The dialog window lists the items you wish to delete. Click the Delete button to confirm.