s3www

README

s3www

Serve static files from any S3 compatible object storage endpoints.

Install

Released binaries are available here, or you can compile yourself from source.

go get github.com/harshavardhana/s3www

Run with Let's Encrypt

Make sure you have index.html under website-bucket

s3www -endpoint "https://s3.amazonaws.com" -accessKey "accessKey" \
      -secretKey "secretKey" -bucket "website-bucket" \
      -lets-encrypt -address "example.com"

s3www: Started listening on https://example.com

Test

Point your web browser to https://example.com ensure your s3www is serving your index.html successfully.

Run locally

Make sure you have index.html under website-bucket

s3www -endpoint "https://s3.amazonaws.com" -accessKey "accessKey" \
      -secretKey "secretKey" -bucket "website-bucket"

s3www: Started listening on http://127.0.0.1:8080

Run with docker

Docker images:

• docker pull y4m4/s3www:<RELEASE_VERSION>
• docker pull y4m4/s3www:latest

Make sure you have index.html under website-bucket

docker run --rm -p 8080:8080 y4m4/s3www:latest \
      -endpoint "https://s3.amazonaws.com" \
      -accessKey "accessKey" \
      -secretKey "secretKey" \
      -bucket "website-bucket" \
      -address "0.0.0.0:8080"

s3www: Started listening on http://0.0.0.0:8080

Test

Point your web browser to http://127.0.0.1:8080 ensure your s3www is serving your index.html successfully.

License

This project is distributed under the Apache License, Version 2.0, see LICENSE for more information.

Buy me a coffee