Do You Know MinIO? A Self-hosted S3 Alternative

Franco — Thu, 10 Apr 2025 19:51:24 +0000

In the world of cloud storage, AWS S3 has been a leader for years. However, for those looking for a self-hosted, open-source alternative to the cloud giants, MinIO is a game-changer. If you haven’t heard of MinIO, it’s a high-performance, S3-compatible object storage solution that is fully open-source and offers the same functionality as Amazon’s S3 service—but with the ability to host it on your own infrastructure.

Whether you're looking to run your own cloud storage on-premise, need something to support local development, or want to have complete control over your data, MinIO provides all the features you need—without vendor lock-in and high costs.

🚀 Introducing the MinIO Node.js + TypeScript API

After discovering MinIO’s potential, I wanted to integrate it into a Node.js environment with TypeScript. So, I created a simple yet powerful REST API that interacts with MinIO to handle basic object storage operations such as uploading, downloading, and deleting files.

🧑‍💻 Why You Should Check Out My Repo

If you’re working with MinIO, or planning to, this repo is for you! It provides a straightforward solution to interact with MinIO, enabling you to quickly manage your objects through a REST API. Here are a few reasons why this could be useful:

S3-compatibility: Whether you're migrating from AWS S3 or just want to use a familiar interface, MinIO supports the same API as S3.

Fully Dockerized: With the included Dockerfile and docker-compose.yml, you can easily spin up your MinIO environment and get started right away.

Production-ready: This setup is ready to handle real-world file storage needs, making it perfect for both development and production environments.

🔧 Key Features:

Simple API built with Node.js and TypeScript, following best practices and making it easy to extend.

File Uploads via multipart/form-data, perfect for images, documents, or any other file type.

S3-Compatible Operations: Upload, download, and delete files from your MinIO bucket just like you would on AWS S3.

Postman Collection: Easily test all the API endpoints before integrating them into your project.

Docker Support: Everything you need to run MinIO on your own infrastructure.

📝 How to Get Started

Getting started with the project is super simple, especially if you're familiar with Docker. Here’s how you can set it up:

git clone https://github.com/androetto/minio-nodejs

Create your .env file: Set up the environment variables for MinIO credentials and endpoint.

Start MinIO using Docker Compose: Run docker-compose up -d to launch the services.

Test the API: Use the included Postman collection to quickly test the upload and delete operations.

🤝 How You Can Contribute

This project is open-source, and I would love for you to contribute! Whether it’s fixing bugs, adding features, or improving the documentation, your help is welcome.

Fork the repo to start contributing.

Create a new branch for your feature.

Open a pull request and let’s make this project even better together.