A Web GUI written in Go to manage S3 buckets from any provider.
- 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
The application can be configured with the following environment variables:
ENDPOINT
: The endpoint of your S3 server (defaults tos3.amazonaws.com
)REGION
: The region of your S3 server (defaults to""
)ACCESS_KEY_ID
: Your S3 access key ID (required) (works only ifUSE_IAM
isfalse
)SECRET_ACCESS_KEY
: Your S3 secret access key (required) (works only ifUSE_IAM
isfalse
)USE_SSL
: Whether your S3 server uses SSL or not (defaults totrue
)SKIP_SSL_VERIFICATION
: Whether the HTTP client should skip SSL verification (defaults tofalse
)SIGNATURE_TYPE
: The signature type to be used (defaults toV4
; valid values areV2, V4, V4Streaming, Anonymous
)PORT
: The port the s3manager app should listen on (defaults to8080
)ALLOW_DELETE
: Enable buttons to delete objects (defaults totrue
)FORCE_DOWNLOAD
: Add response headers for object downloading instead of opening in a new tab (defaults totrue
)LIST_RECURSIVE
: List all objects in buckets recursively (defaults tofalse
)USE_IAM
: Use IAM role instead of key pair (defaults tofalse
)IAM_ENDPOINT
: Endpoint for IAM role retrieving (Can be blank for AWS)SSE_TYPE
: Specified server side encrpytion (defaults blank) Valid values can beSSE
,KMS
,SSE-C
all others values don't enable the SSESSE_KEY
: The key needed for SSE method (only forKMS
andSSE-C
)TIMEOUT
: The read and write timout in seconds (default to600
- 10 minutes)
- Run
make build
- Execute the created binary and visit https://localhost:8080
- Run
docker run -p 8080:8080 -e 'ACCESS_KEY_ID=XXX' -e 'SECRET_ACCESS_KEY=xxx' cloudlena/s3manager
You can deploy s3manager to a Kubernetes cluster using the Helm chart.
- Run
make lint
- Run
make test
The image is available on Docker Hub.
- Run
make build-image
There is an example docker-compose.yml file that spins up an S3 service and the s3manager. You can try it by issuing the following command:
$ docker-compose up