Getting Started

Bucket Commander is a web-based S3 bucket browser for Eyevinn Open Source Cloud. It provides a dual-pane Norton Commander-style interface for navigating, uploading, and managing files across your OSC-managed storage buckets. No local tools or CLI setup required.

Prerequisites

  • An Eyevinn OSC account. If you have not already signed up, the free trial gives you 15 days of access.
  • An OSC Personal Access Token. You can generate one in Settings under the API Tokens section.

Step 1: Store your access token as a secret

Navigate to the Bucket Commander service and open the Service Secrets tab. Create a new secret named osctoken and paste in your OSC Personal Access Token.

Why a secret? Storing the token as a secret keeps it out of your instance configuration and allows you to rotate it without recreating the instance.

Step 2: Create a Bucket Commander instance

Go to the My bucket-commanders tab and click Create bucket-commander.

Field Value
Name A name for this instance (alphanumeric)
OscAccessToken {{secrets.osctoken}}

When the instance status turns green, click on its card to open the Bucket Commander interface.

Using Bucket Commander

The dual-pane interface lets you navigate your OSC storage buckets in both panels. Use the toolbar to:

  • Browse and navigate directories
  • Upload and download files
  • Copy and move files between buckets or paths
  • Delete files

Credentials are stored in the browser session — they are never sent to any third-party service.

CLI Usage

osc create birme-bucket-commander mybrowser \
  -o OscAccessToken="{{secrets.osctoken}}"

Resources