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
drive: storage
Parameters
| Variable | Default | Description |
|---|---|---|
access_key |
admin |
MinIO user credential |
secret_key |
admin |
MinIO password credential |
drive |
storage |
Folder where MinIO data will be saved inside /data |
🚀 Installation
- Go to Home Assistant → Supervisor → Add-on Store
- Add this repository (Settings → Repositories →
https://github.com/martemme/HomeAssistantAddons) - Install the add-on, configure the credentials and start it
🌐 Access
Once installed, access MinIO via the sidebar or at:
http://<ip_hass>:9000 (if Ingress is not available)
🧾 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 # Startup script
├── README.md
└── ...
🧠 Notes
The credentials are passed as environment variables during bootstrap.
The container is based on alpine:3.18 image
🛡 Security
⚠️ Always use strong passwords.
Consider enabling automatic TLS by placing certificates in /ssl/.
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.