Description

Cloud Explorer is a open-source S3 client. It works on Windows, Linux, and Mac. It has a graphical and command line interface for each supported operating system. If you have a feature suggestion or find a bug, please open an issue.

Features

• Search
• Performance testing
• Music player
• Transition buckets to Amazon Glacier
• Amazon RRS and Infrequently Accessed storage tiers
• Migrate buckets between S3 accounts
• Compress files prior to upload
• Take screen shots to S3
• Simple text editor
• IRC client
• Share buckets with users
• Access shared buckets
• View images
• Sync folders
• Graph CSV files and save them to a bucket
• Record audio messages and save them to a bucket
• Create snapshots of buckets

System Requirements

• Java 11
• S3 credentials

Downloading

For the latest stable release, click Download.

How to run the program

To run the application, most users should be able to run the program by double clicking on the CloudExplorer.jar file.

If not, you can start the program with the Java command:

java -jar CloudExplorer.jar

How to compile from source

1. Install and Configure Java

apt-get update
apt-get -y install git ant openjdk-11-jdk

2. Clone this repository and run ant to compile the project

git clone https://github.com/rusher81572/cloudExplorer.git
cd cloudExplorer
ant

3. Install the AWS Libraries

bash upgrade-sdk.sh

4. Run Cloud Explorer

Double click on dist/CloudExplorer.jar
or....
java -jar dist/CloudExplorer.jar help

Upgrading

To upgrade, please use the updater located in the application. Everytime Cloud Explorer is ran, it will check for the latest version. To apply the update, click "Help -> Check for updates".

How to migrate data between S3 accounts

• Load the destination account and create or select a bucket to migrate to.
• From the menu "Snapshots and Migration", click "Set Migration/Snapshot Account and Bucket".
• Switch to the origin account and select the bucket to migrate.
• Under the "Snapshots and Migration", select "Migration".
• Click "Start Migration".

How to create a bucket snapshot

• Load the destination account and create or select a bucket to store the snapshot.
• From the menu "Snapshots and Migration", click "Set Migration/Snapshot Account and Bucket".
• Switch to the origin account and select the bucket to snap.
• Under the "Snapshots and Migration", select "Snapshots".
• Click "Create Snapshot".

Running Cloud Explorer in Docker

The following steps will explain how to run Cloud Explorer from a Docker container. The template will install an Ubuntu container using the FVWM window manager.

Creating the container

First, clone this repo:

git clone https://github.com/rusher81572/cloudExplorer.git
cd cloudExplorer

If you want to use your existing S3 configuration file, copy s3.config from your home directory into the cloudExplorer directory. Modify DockerFile by adding the following before the CMD line:

ADD s3.config /root/

Build the container

docker build -t cloudexplorer .

Running the container - CLI

To use environment variables to store S3 account information when using the Cloud Explorer CLI instead of uploading an s3.config file:

docker run -it --net=host -e ACCESS_KEY='****' -e SECRET_KEY='***' -e ENDPOINT='https://s3.amazonaws.com:443' -e REGION='default' cloudexplorer bash
java -jar /cloudExplorer/dist/CloudExplorer.jar help

If you want to use the Cloud Explorer CLI from a VNC session, skip to "Using the CLI in VNC".

Running the container - GUI

Run the container:

docker run -d -p 6001:6001 -p 5901:5901 cloudexplorer

To access to the container, use a VNC client such as vncviewer to connect to display #1.

vncviewer docker_host_ip:1

The default password for VNC is 123456. You should see the Cloud Explorer GUI after authentication.

Using the CLI in VNC

If you want to use the Cloud Explorer CLI, start a terminal in the VNC session by right clicking on the desktop and choose "xterm". Finally, run the following command:

java -jar /cloudExplorer/dist/CloudExplorer.jar help