Files
HomeAssistantAddons/minio/README.md

2.9 KiB

Home Assistant Add-on: MinIO

Supports amd64 Architecture Supports aarch64 Architecture

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

  1. Go to Home Assistant → Supervisor → Add-on Store
  2. Add this repository (Settings → Repositories → https://github.com/martemme/HomeAssistantAddons)
  3. 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.