How to Test S3 Integrations Locally Without AWS

H

gofakes3 is a lightweight S3 clone written in Go that runs locally. It provides a fake AWS S3 server for testing without cloud dependencies.

The tool focuses specifically on the API surface needed for testing, making it significantly lighter and faster than alternatives like MinIO. It eliminates AWS costs from development and CI pipelines while ensuring reproducible tests. Teams can onboard new members without AWS credentials and integrate S3 testing into automated pipelines.

gofakes3 repo

Project Repository

Project link:
https://github.com/johannesboyne/gofakes3/

How to Deploy & How It Works

gofakes3 works as a standalone server or as a library in Go tests. You can start the server with a single command and use it for testing S3 integrations locally. This approach is similar to other local development tools like Skales, which also eliminate external dependencies.

Threads user, in response to gofakes3

To deploy gofakes3, follow these steps in exact order:

  1. Install Go on your local machine if not already present.
  2. Clone the gofakes3 repository from GitHub.
  3. Run the server using the provided binary or integrate it as a library in your Go tests.
  4. Configure your S3 client to point to the local endpoint (e.g., http://localhost:9000).
  5. Execute your tests against the local S3 server.

This workflow mirrors the approach used by Gstack for orchestrating AI teams, where local simulation reduces external dependencies. Both tools prioritize developer efficiency and cost elimination.

The Verdict / The Catch

gofakes3 is not a full S3‑compatible object storage solution. It focuses on the API surface needed for testing, which makes it lightweight but limited for production use. If you need a full S3 replacement, consider alternatives like MinIO forks. For local testing and CI pipelines, gofakes3 delivers exactly what developers need: a fast, reliable, and free way to test S3 integrations.

About the author

Hairun Wicaksana

Hi, I just another vibecoder from Southeast Asia, currently based in Stockholm. Building startup experiments while keeping close to the KTH Innovation startup ecosystem. I focus on AI tools, automation, and fast product experiments, sharing the journey while turning ideas into working software.

Get in touch

Quickly communicate covalent niche markets for maintainable sources. Collaboratively harness resource sucking experiences whereas cost effective meta-services.