Home Assistant Add-on: MinIO

This add-on provides an S3-compatible server based on MinIO, perfect for:

File/media storage
Logging or custom integrations

It is designed to be production-ready, secure, lightweight, and accessible directly via the Home Assistant sidebar.

⚙️ Configuration

access_key: admin
secret_key: CHANGEME-strong-password
region: us-east-1
bucket: backup

🌐 Access

Once installed, access MinIO via the sidebar or at:

http://<ip_hass>:9000 (if Ingress is not available)

🚀 Installation

Go to Home Assistant → Supervisor → Add-on Store
Add your custom Git repository (Settings → Repositories → https://github.com/<your-username>/minio-addon)
Install the add-on, start it, and access MinIO via Ingress

🧾 Requirements

Home Assistant OS or Supervised
Supported architecture: amd64, aarch64
Access to a persistent folder for /data

📂 Repository Structure

minio/
├── config.json         # Add-on definition
├── Dockerfile          # MinIO container
├── run.sh              # Entry point with TLS support and auto-creation of buckets
├── README.md
└── ...

🧠 Notes

The bucket specified in bucket: is automatically created if it does not exist.

If you use Longhorn, you can point backups to:

http://<IP_HASS>:9000/longhorn-backup

The credentials are passed as environment variables during bootstrap.

🛡 Security

⚠️ Always use strong passwords.

Consider enabling automatic TLS by placing certificates in /ssl/.

✅ Future TODOs

Support for bucket versioning
Healthcheck and Prometheus metrics
Interface for managing users/buckets via options

Changelog & Releases

Releases are based on Semantic Versioning, and use the format of MAJOR.MINOR.PATCH. In a nutshell, the version will be incremented based on the following:

MAJOR: Incompatible or major changes.
MINOR: Backwards-compatible new features and enhancements.
PATCH: Backwards-compatible bugfixes and package updates.

Made with ❤️ for automation and resilience.

2.8 KiB Raw Blame History