HomeBox est ton application d'inventaire et de gestion de biens (Asset & Inventory Management).
Conçue pour le Homelab, elle te permet de retrouver instantanément n'importe quel objet, de conserver les factures/numéros de série et de gérer les garanties.
Cas d'usage
✨ Savoir exactement dans quel tiroir se trouve un objet.
💸 Archiver les PDF de factures pour les assurances.
📅 Filtrer les équipements par fin de garantie.
🏷️ Suivre le matériel prêté à des amis.
Infrastructure (Geekom A5)
🐳 Exécution Rootless via Podman.
⚙️ Gestionnaire de service via Quadlet Systemd.
🔒 Reverse Proxy via Caddy.
💾 Backup automatisé vers NAS Synology.
🚀 SOP : Installation sur Geekom A5 (v1.3)
Déploiement avec Podman et Quadlet Systemd sur le réseau reseau-portail (IP allouée : 10.89.1.139).
Phase 1 & 2 : Pull et Préparation des Répertoires
bash
# 1. Vérification de l'image
podman pull ghcr.io/sysadminsmedia/homebox:latest
# 2. Création du répertoire de données
mkdir -p /home/mourad/apps/homebox/data
# 3. Attribution des droits pour le conteneur Rootless (UID/GID 1000)
podman unshare chown -R 1000:1000 /home/mourad/apps/homebox/data
Phase 3 : Configuration du Quadlet Systemd
Commencez par générer un secret de 48 octets pour HBOX_AUTH_API_KEY_PEPPER :
bash
openssl rand -base64 48
Ensuite, créez le fichier Quadlet nano ~/.config/containers/systemd/homebox.container :
systemd
[Unit]
Description=Homebox - Asset and Inventory Management
After=network-online.target
[Container]
Image=ghcr.io/sysadminsmedia/homebox:latest
ContainerName=homebox
Network=reseau-portail:ip=10.89.1.139
Volume=%h/apps/homebox/data:/data:Z
Environment=HBOX_MODE=production
Environment=HBOX_WEB_PORT=7745
# Laissez false ci-dessous, la création de compte se fera plus tard ou modifiez à true pour le 1er lancement
Environment=HBOX_OPTIONS_ALLOW_REGISTRATION=true
Environment=HBOX_AUTH_API_KEY_PEPPER=InserezIciLeSecretGenereParOpenssl
[Service]
Restart=always
[Install]
WantedBy=default.target
Phase 4 & 5 : Caddy, DNS et Démarrage
bash
# 1. Ajout dans le Caddyfile (~/caddy_config/Caddyfile) :
# homebox.mso001fr.ovh {
# reverse_proxy homebox:7745
# }
# 2. DNS AdGuard Home : Ajouter la réécriture ||homebox.mso001fr.ovh^ -> 192.168.1.7
# 3. Démarrage du service
systemctl --user daemon-reload
systemctl --user restart homebox.service
# 4. Synchro des AddHost et rechargement Caddy
~/script/sync-quadlet-hosts.sh
podman exec proxy-caddy caddy reload --config /etc/caddy/Caddyfile
⚙️ Post-Installation & Sécurisation
!
Création du compte (HTTPS Obligatoire)
En HBOX_MODE=production, Homebox impose l'utilisation de Secure Cookies. Tu dois obligatoirement
passer par le reverse proxy sécurisé : https://homebox.mso001fr.ovh.
Note : Le bouton d'inscription reste grisé tant que le mot de passe est jugé "Very weak". Utilise majuscules, chiffres et caractères spéciaux.
1
Verrouillage des Inscriptions (Sécurité)
Maintenant que ton compte administrateur est créé, bloque les nouvelles inscriptions :
Édite le Quadlet : nano ~/.config/containers/systemd/homebox.container
Passe la variable à false : Environment=HBOX_OPTIONS_ALLOW_REGISTRATION=false
Infos Assurances : Prix d'achat, Date, N° de Série, Fin de garantie.
Attachments : Ajoute une photo claire et le PDF de la facture.
Routine d'Utilisation (Nouvel Achat)
Prendre une photo & scanner le ticket/facture (PDF).
Créer l'objet dans Homebox (Nom, Emplacement, Prix, N° Série).
Attacher la photo + le PDF de la facture.
🛠️ Utilisation Avancée
Utiliser les Tags (Étiquettes)
Les tags permettent de regrouper des objets de manière transversale :
Prêts : Tag #Prêté (ajoute une note "Prêté à Thomas le 15/02").
Garantie : Filtre par #Garantie pour les objets couverts.
Maintenance :#BatterieÀChanger ou #EntretienÀFaire.
QR-Codes et Étiquettes
Homebox génère un QR Code unique pour chaque fiche objet ou emplacement.
Imprime l'étiquette depuis l'interface web.
Colle-la sur une boîte (ex: bac à outils).
En scannant via téléphone (sur réseau local ou VPN), tu accèdes directement au contenu exact de la boîte !
Sauvegarde Automatique
Le dossier de données de Homebox a été volontairement placé dans /home/mourad/apps/homebox/data.
De ce fait, il est automatiquement inclus dans ton script quotidien ~/script/backup-full.sh.
Une copie Rsync est faite vers /mnt/backup/geekom_backup/apps/ avec une réplication complète sécurisée sur ton NAS Synology.