This minimal repo demonstrates how to upload files directly to S3 from a front-end application using signed URLs. The repo uses MinIO as a local S3 alternative so that the code can be run without creating a bucket on a cloud provider.
The front-end code is written without a front-end framework in order to maximize portability. The back-end code that generates the signed URLs uses Node.js and Express.
This project requires Bash, Docker and Docker Compose.
A Bash set-up script has been included with this repo. It will do the following when executed:
- Install npm dependencies on the host machine for both the
frontendandbackendservices. - Create an
uploadsbucket in MinIO.
You can run the set-up script from the main project directory with the following command:
./bin/set-up-localIf you're using Docker Desktop on MacOS or Windows, you can start the project by running the following command from the main project directory:
docker-compose upIf you are running Docker on Linux and not using Docker Desktop, starting the project with docker-compose up may cause permission conflicts between the containers and the host. A script has been included to run the project on Linux while mitigating permission conflicts:
./bin/runOnce the project is running, you can view it in the browser by visiting http://localhost:3000.
After uploading files, you can view the uploads in the MinIO console at http://localhost:9090. From there, you can log into MinIO with the following credentials:
username: admin
password: password