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.
For the latest development release, please download cloudExplorer-dev.zip from Amazon S3. 
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