Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jessfraz/s3server
Server to index & view files in a s3 or Google Cloud Storage bucket.
https://github.com/jessfraz/s3server
Last synced: 10 days ago
JSON representation
Server to index & view files in a s3 or Google Cloud Storage bucket.
- Host: GitHub
- URL: https://github.com/jessfraz/s3server
- Owner: jessfraz
- License: mit
- Created: 2015-10-05T08:30:02.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2023-02-25T00:56:17.000Z (over 1 year ago)
- Last Synced: 2024-08-02T15:47:51.081Z (3 months ago)
- Language: Go
- Homepage: https://gifs.jessfraz.com
- Size: 28 MB
- Stars: 244
- Watchers: 6
- Forks: 24
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - jessfraz/s3server - Server to index & view files in a s3 or Google Cloud Storage bucket. (others)
README
# s3server
[](https://github.com/jessfraz/s3server/actions?query=workflow%3A%22make+all%22)
[](https://github.com/jessfraz/s3server/actions?query=workflow%3A%22make+image%22)
[](https://godoc.org/github.com/jessfraz/s3server)
Static server for s3 or gcs files.
**Table of Contents**
- [Installation](#installation)
- [Binaries](#binaries)
- [Via Go](#via-go)
- [Usage](#usage)
## Installation
#### Binaries
For installation instructions from binaries please visit the [Releases Page](https://github.com/jessfraz/s3server/releases).
#### Via Go
```console
$ go get github.com/jessfraz/s3server
```
## Usage
```console
$ s3server -h
s3server - Server to index & view files in a s3 or Google Cloud Storage bucket.
Usage: s3server
Flags:
--bucket bucket path from which to serve files (default: )
--cert path to ssl certificate (default: )
-d enable debug logging (default: false)
--interval interval to generate new index.html's at (default: 5m0s)
--key path to ssl key (default: )
-p port for server to run on (default: 8080)
--provider cloud provider (ex. s3, gcs) (default: s3)
--s3key s3 access key (default: )
--s3region aws region for the bucket (default: us-west-2)
--s3secret s3 access secret (default: )
Commands:
version Show the version information.
```
**run with the docker image**
```console
# On AWS S3
$ docker run -d \
--restart always \
-e AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY \
-p 8080:8080 \
--name s3server \
--tmpfs /tmp \
r.j3ss.co/s3server -bucket s3://hugthief/gifs
# On Google Cloud Storage
$ docker run --restart always -d \
--name gifs \
-p 8080:8080 \
-v ~/configs/path/config.json:/creds.json:ro \
-e GOOGLE_APPLICATION_CREDENTIALS=/creds.json \
--tmpfs /tmp \
r.j3ss.co/s3server -provider gcs -bucket gcs://misc.j3ss.co/gifs
```
