https://github.com/cloudlena/s3manager

A Web GUI for your S3 buckets
https://github.com/cloudlena/s3manager

go golang gui material-design s3

Last synced: 2 days ago
JSON representation

A Web GUI for your S3 buckets

• Host: GitHub
• URL: https://github.com/cloudlena/s3manager
• Owner: cloudlena
• License: other
• Created: 2016-12-18T21:53:45.000Z (about 8 years ago)
• Default Branch: main
• Last Pushed: 2024-11-26T21:58:58.000Z (26 days ago)
• Last Synced: 2024-12-14T01:05:06.746Z (9 days ago)
• Topics: go, golang, gui, material-design, s3
• Language: Go
• Homepage:
• Size: 9.53 MB
• Stars: 501
• Watchers: 7
• Forks: 95
• Open Issues: 29
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# S3 Manager

[![Go Report Card](https://goreportcard.com/badge/github.com/cloudlena/s3manager)](https://goreportcard.com/report/github.com/cloudlena/s3manager)

[![Build Status](https://github.com/cloudlena/s3manager/actions/workflows/main.yml/badge.svg)](https://github.com/cloudlena/s3manager/actions)

A Web GUI written in Go to manage S3 buckets from any provider.

![Screenshot](https://raw.githubusercontent.com/cloudlena/s3manager/main/screenshot.png)

## Features

- List all buckets in your account

- Create a new bucket

- List all objects in a bucket

- Upload new objects to a bucket

- Download object from a bucket

- Delete an object in a bucket

## Usage

### Configuration

The application can be configured with the following environment variables:

- `ENDPOINT`: The endpoint of your S3 server (defaults to `s3.amazonaws.com`)

- `REGION`: The region of your S3 server (defaults to `""`)

- `ACCESS_KEY_ID`: Your S3 access key ID (required) (works only if `USE_IAM` is `false`)

- `SECRET_ACCESS_KEY`: Your S3 secret access key (required) (works only if `USE_IAM` is `false`)

- `USE_SSL`: Whether your S3 server uses SSL or not (defaults to `true`)

- `SKIP_SSL_VERIFICATION`: Whether the HTTP client should skip SSL verification (defaults to `false`)

- `SIGNATURE_TYPE`: The signature type to be used (defaults to `V4`; valid values are `V2, V4, V4Streaming, Anonymous`)

- `PORT`: The port the s3manager app should listen on (defaults to `8080`)

- `ALLOW_DELETE`: Enable buttons to delete objects (defaults to `true`)

- `FORCE_DOWNLOAD`: Add response headers for object downloading instead of opening in a new tab (defaults to `true`)

- `LIST_RECURSIVE`: List all objects in buckets recursively (defaults to `false`)

- `USE_IAM`: Use IAM role instead of key pair (defaults to `false`)

- `IAM_ENDPOINT`: Endpoint for IAM role retrieving (Can be blank for AWS)

- `SSE_TYPE`: Specified server side encrpytion (defaults blank) Valid values can be `SSE`, `KMS`, `SSE-C` all others values don't enable the SSE

- `SSE_KEY`: The key needed for SSE method (only for `KMS` and `SSE-C`)

- `TIMEOUT`: The read and write timout in seconds (default to `600` - 10 minutes)

### Build and Run Locally

1.  Run `make build`

1.  Execute the created binary and visit 

### Run Container image

1. Run `docker run -p 8080:8080 -e 'ACCESS_KEY_ID=XXX' -e 'SECRET_ACCESS_KEY=xxx' cloudlena/s3manager`

### Deploy to Kubernetes

You can deploy s3manager to a Kubernetes cluster using the [Helm chart](https://github.com/sergeyshevch/s3manager-helm).

## Development

### Lint Code

1. Run `make lint`

### Run Tests

1.  Run `make test`

### Build Container Image

The image is available on [Docker Hub](https://hub.docker.com/r/cloudlena/s3manager/).

1.  Run `make build-image`

### Run Locally for Testing

There is an example [docker-compose.yml](https://github.com/cloudlena/s3manager/blob/main/docker-compose.yml) file that spins up an S3 service and the s3manager. You can try it by issuing the following command:

```shell

$ docker-compose up

```

## GitHub Stars

[![GitHub stars over time](https://starchart.cc/cloudlena/s3manager.svg?variant=adaptive)](https://starchart.cc/cloudlena/s3manager)