v1.3

Added

• Folder marker support: PUT with trailing slash (e.g., folder/) creates directories
• DELETE support for folder markers
• Empty directories persist after deleting files inside (S3-like behavior)
• Makefile with test-unit, test-integration-up, test-integration-down, build commands
• Folder marker integration tests

Fixed

• ListObjects prefix filter now correctly matches directories with trailing slashes
• Directories now report size 0 instead of filesystem block size

Improved

• Storage test coverage increased to 80%
• Makefile clears test cache and greps for FAIL to catch errors

v1.2

Added

• Version information in /health endpoint response: {"status":"ok","version":"v1.2"}
• Version logged on server startup: SelfhostS3 v1.2 starting on :9000

Full Changelog

v1.1...v1.2

v1.1 - CORS Fix for AWS SDK v3

What's Changed

Fixed

• CORS headers now use wildcards (*) for Access-Control-Allow-Headers and Access-Control-Expose-Headers to support AWS SDK v3 and other S3 clients that send custom headers like amz-sdk-invocation-id and amz-sdk-request

Added

• Comprehensive CORS integration tests
• CHANGELOG.md for tracking changes

Improved

• Test coverage increased to 86.3% overall

Upgrade

docker pull notifuse/selfhost_s3:v1.1

Or use notifuse/selfhost_s3:latest for the most recent version.

Full Changelog: v1.0...v1.1

v1.0 - Initial Stable Release

selfhost_s3 v1.0

A minimal S3-compatible object storage server written in Go that persists files to the local filesystem. Designed for development and self-hosted deployments where a full S3 service is overkill.

Features

• S3-compatible API with AWS Signature V4 authentication
• Local filesystem storage - no external dependencies
• Public file access - serve files without authentication via configurable prefix
• Cache headers - configurable Cache-Control for public files
• Download mode - force file download with ?download=1 query parameter
• Multi-platform Docker images - supports amd64 and arm64

Supported S3 Operations

Operation	Description
GetObject	Download/serve files
HeadObject	Check file metadata
PutObject	Upload files
DeleteObject	Delete files
ListObjectsV2	List bucket contents

Quick Start

docker run -d \
  --name selfhost_s3 \
  -p 9000:9000 \
  -v $(pwd)/data:/data \
  -e S3_BUCKET=my-bucket \
  -e S3_ACCESS_KEY=myaccesskey \
  -e S3_SECRET_KEY=mysecretkey \
  notifuse/selfhost_s3:v1.0

Configuration

Variable	Required	Default	Description
S3_BUCKET	Yes	-	S3 bucket name
S3_ACCESS_KEY	Yes	-	Access key for authentication
S3_SECRET_KEY	Yes	-	Secret key for authentication
S3_PORT	No	9000	Port to listen on
S3_STORAGE_PATH	No	./data	Local directory for file storage
S3_REGION	No	us-east-1	AWS region (for signature validation)
S3_CORS_ORIGINS	No	*	Allowed CORS origins
S3_MAX_FILE_SIZE	No	100MB	Maximum upload file size
S3_PUBLIC_PREFIX	No	public/	Prefix for public files (empty disables)
S3_PUBLIC_CACHE_MAX_AGE	No	31536000	Cache-Control max-age for public files

Public File Access

Files under the public/ prefix can be accessed without authentication:

# Upload (requires auth)
aws s3 cp image.png s3://my-bucket/public/image.png --endpoint-url http://localhost:9000

# Access publicly (no auth)
curl http://localhost:9000/my-bucket/public/image.png

# Force download
curl http://localhost:9000/my-bucket/public/image.png?download=1

Docker Images

Available on Docker Hub:

• notifuse/selfhost_s3:v1.0
• notifuse/selfhost_s3:latest

---

Full documentation: README.md