Homebox

Objets, pièces et cartons dans une seule arborescence

Homebox tient l'inventaire de ce qu'on possède chez soi : chaque objet porte ses photos, son emplacement, son prix d'achat, sa garantie, ses factures et son carnet d'entretien. Depuis la version 0.26, objets et emplacements sont des « entités » du même modèle : une pièce ou un carton a ses propres photos et champs personnalisés, et contient d'autres entités. Le serveur est écrit en Go, l'interface en Nuxt, et le tout tourne dans un conteneur avec SQLite par défaut. Le README annonce moins de 50 Mo de mémoire au repos pour ce conteneur.

Étiquettes QR imprimables et rappels d'entretien

• Étiquettes QR : chaque objet et chaque emplacement a son code QR, et un générateur met en page des planches d'étiquettes à imprimer. Le mode « AR » du scanner, que l'équipe présente comme une expérience, affiche par-dessus l'image de la caméra le contenu du carton visé.
• Recherche tolérante : sur SQLite, cafe trouve « café » sans aucun réglage, les guillemets cherchent une expression exacte et #000-001 ouvre un objet par son numéro d'inventaire. Meilisearch se branche en option pour absorber les fautes de frappe.
• Rappels d'entretien : les échéances partent par Shoutrrr vers ntfy, Gotify, Matrix, Telegram, un e-mail SMTP ou un webhook.
• Plusieurs collections par instance : des inventaires séparés dans la même installation, partageables avec la famille ou des colocataires. La connexion OIDC (Authentik, Keycloak, Authelia...) peut réserver l'accès à certains groupes.

Retrouver un carton à la cave ou chiffrer un sinistre

• Chiffrer un sinistre pour l'assureur : un objet se marque comme assuré, avec son prix d'achat et sa facture jointe, et la fiche d'une pièce affiche la valeur totale de ce qu'elle contient.
• Coller une étiquette sur chaque carton de cave ou de déménagement, puis la scanner pour lister ce qu'il renferme.
• Quitter un tableur par l'import CSV, puis alimenter d'autres outils par l'API REST avec une clé hb_, qui reçoit les droits de l'utilisateur qui l'a créée.

Une reprise en 0.x qui exige un secret au démarrage

Le dépôt reprend un projet archivé. sysadminsmedia/homebox se présente comme la suite du HomeBox de hay-kot ; le dépôt d'origine n'a reçu aucun push depuis juin 2024.

La cible est le foyer. La documentation écarte Snipe-IT, qu'elle décrit comme un outil de gestion de parc pour des centaines d'appareils en entreprise, trop long à configurer pour un particulier. SQLite suffit aux petites installations ; pour les grandes, elle recommande PostgreSQL, qui permet de répartir la charge sur plusieurs instances de Homebox.

Un secret de 32 octets est exigé avant le premier démarrage. Depuis la 0.26, Homebox refuse de démarrer si HBOX_AUTH_API_KEY_PEPPER fait moins de 32 octets, et changer cette valeur invalide toutes les clés API déjà émises. La valeur d'exemple de la page d'installation, some_random_string, n'en compte que 18 ; le README génère la sienne avec openssl rand -base64 48.

Docker reste la voie recommandée. Des binaires sortent pour Linux, macOS, FreeBSD et Windows, mais l'équipe ne valide que Linux : elle n'a pas de Mac pour tester et signale des problèmes connus sous Windows. La documentation conseille donc Docker en production. Depuis la 0.27.0, les notifications vers localhost sont bloquées par défaut ; un ntfy installé sur la même machine se joint alors par son adresse sur le réseau local, ou après HBOX_NOTIFIER_BLOCK_LOCALHOST=false.

La dernière version, 0.27.1, date du 23 octobre 2026. Les versions 0.25, 0.26 et 0.27 sont sorties en avril, juin et octobre 2026, chacune après une release candidate. La 0.26 a remplacé les routes /v1/items et /v1/locations de l'API par /v1/entities, et la 0.27.0 a corrigé quinze failles de sécurité. L'export d'une collection entière en ZIP reste marqué expérimental. Le code est sous licence AGPL-3.0.