HassOS Apps Repository

A curated ecosystem of purpose-built Home Assistant apps, crafted with structure, clarity and long-term reliability.

Installation

1. In Home Assistant, go to Settings → Apps → App Store
2. Click the menu (⋮) → Repositories
3. Add: https://github.com/hassos-apps/repository

Or click the badge above to add the repository directly.

Available Apps

App	Description	Version	Architectures
Example	Example app for the HassOS Apps ecosystem	1.0.0	amd64, aarch64
Homebox	Inventory and organization system for the Home User	0.24.2	amd64, aarch64
Shelly Manager	Local management for Shelly IoT devices without cloud connectivity.	1.0.0	amd64, aarch64

How It Works

This repository is the app store index for the HassOS Apps ecosystem. Home Assistant reads the per-app directories to display metadata, documentation, icons and translations in its UI.

Each app directory is automatically synced via repository_dispatch when an app is deployed. The following files are copied from each app's source repository:

{slug}/
├── config.yaml          # App metadata, options and schema
├── build.yaml           # Per-architecture base images
├── DOCS.md              # User-facing documentation (shown in HA UI)
├── CHANGELOG.md         # Version history (Keep a Changelog format)
├── README.md            # App README (from repo root)
├── icon.png             # 128×128 app icon
├── logo.png             # 250×100 app logo
├── apparmor.txt         # AppArmor security profile
└── translations/
    └── en.yaml          # English UI translations

Do not edit app directories manually — they are overwritten on every deploy.

Security

All apps include custom AppArmor profiles, use minimal permissions and receive regular dependency updates. See SECURITY.md in each app for details.

---

HassOS Apps — purpose-built Home Assistant apps, crafted with structure, clarity and long-term reliability.