A Web GUI for your S3 buckets. Based on Cloudlena S3 Manager
Find a file
2020-12-16 20:51:15 +01:00
.github/workflows Rename GitHub pipeline 2020-12-09 09:35:54 +01:00
cmd/s3manager Allow to use non-encrypted connections 2020-05-27 23:28:36 +02:00
deployments/cf Fixes filname in command declaration 2020-06-02 23:19:17 +02:00
internal/app/s3manager fix upload failures when using AWS S3 2020-12-16 20:51:15 +01:00
web/template Use Go 1.15 2020-10-13 16:02:02 +02:00
.cfignore Upgrade minio-go to 6.0.10 2018-11-28 21:13:47 +01:00
.dockerignore Use official golangci-lint GitHub action 2020-07-21 09:02:26 +02:00
.gitignore Upgrade minio-go to 6.0.10 2018-11-28 21:13:47 +01:00
.golangci.yml Parallelize tests 2020-12-07 09:53:50 +01:00
docker-compose.yml Use official golangci-lint GitHub action 2020-07-21 09:02:26 +02:00
Dockerfile add certificates 2020-12-16 20:51:15 +01:00
go.mod Rename GitHub pipeline 2020-12-09 09:35:54 +01:00
go.sum Rename GitHub pipeline 2020-12-09 09:35:54 +01:00
LICENSE Use Apache 2.0 license 2017-03-31 13:43:07 +02:00
localstack-compose.yml Update dependencies 2020-06-29 09:44:33 +02:00
localstack.yml Update dependencies 2020-06-29 09:44:33 +02:00
Makefile Use Go 1.13 2020-02-17 09:38:47 +01:00
README.md Update dependencies 2020-11-09 09:46:58 +01:00
screenshot.png Add usage documentation 2020-05-04 10:36:17 +02:00

S3 Manager

Go Report Card Build Status Docker Build

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

Screenshot

Usage

Configuration

The application can be configured with the following environment variables:

  • ENDPOINT: The endpoint of your S3 server (defaults to s3.amazonaws.com)
  • ACCESS_KEY_ID: Your S3 access key ID (required)
  • SECRET_ACCESS_KEY: Your S3 secret access key (required)
  • USE_SSL: Whether your S3 server uses SSL or not (defaults to true)
  • PORT: The port the s3manager app should listen on (defaults to 8080)

Build and Run Locally

  1. Run make build
  2. Execute the created binary and visit http://localhost:8080

Run Docker image

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

Deploy to Cloud Foundry

  1. Modify deployments/cf/* to your liking
  2. Run make deploy-cf

Development

Lint Code

  1. Run make lint

Run Tests

  1. Run make test

Build Docker Image

The image is available on Docker Hub

  1. Run make build-docker

Run Locally for Testing

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