Installer HomeBox avec Docker

zarev 7 janv. 2024 4 min de lecture

Table des matières

En mettant l'accent sur la simplicité et la facilité d'utilisation, Homebox est la solution parfaite pour vos besoins d'inventaire, d'organisation et de gestion de votre maison.

⚡Caractéristiques:

Simple: Homebox est conçu pour être simple et facile à utiliser. Aucune installation ou configuration compliquée requise.
Rapide: Homebox est écrit en Go, ce qui le rend extrêmement rapide et nécessite un minimum de ressources pour son déploiement.
Portable: Homebox est conçu pour être portable et fonctionner n’importe où.
Créez et gérez des éléments en fournissant un nom et une description - C'est tout ! Homebox ne nécessite que quelques détails pour créer un élément, après quoi vous pouvez spécifier autant de détails que vous le souhaitez, ou masquer certaines des choses dont vous n'aurez jamais besoin.
Les détails facultatifs pour les articles incluent: Informations de garantie, informations sur le produit vendu, informations ou a été acheté le produit, identifications des articles (série, modèle, etc.), pièces jointes (images, manuels, ...), champs personnalisés.
Import/Export CSV pour créer et gérer rapidement des éléments.
Rapports personnalisés.
Exportation de nomenclatures.
Générateur d'étiquettes QR code.
Organisez les éléments en créant des étiquettes et des emplacements et en les attribuant aux éléments.
Prise en charge multi-locataires : tous les utilisateurs sont placés dans un groupe et ne peuvent voir que les éléments de leur groupe. Invitez des membres de votre famille à votre groupe ou partagez une instance entre amis !
Plusieurs langues disponibles, dont le français.

Un truc que j'aime vraiment beaucoup c'est le générateur de QR code.

Imaginons que vous ayez une caisse avec divers objets, vous prenez une photo de l'intérieur de la caisse avec tout son contenu, vous ajoutez votre caisse dans Homebox et en scannant simplement le QR code de la caisse, vous voyez tous les objets étant dedans sans avoir à l'ouvrir. Pas mal non?

💾 L'installation

Avec Cosmos Cloud

Cette application peut-être installée en un clic sur votre Cosmos Cloud en cliquant sur l'image ci-dessous:

Avec Docker-compose

Créez votre docker-compose.yml:

sudo nano compose.yml

Collez ça dedans en prenant soin d'adapter le port et les volumes suivant votre configuration:

version: '3.9'
services:
    sysadminsmedia:
        image: 'ghcr.io/sysadminsmedia/homebox:latest'
        volumes:
            - './data:/data'
        environment:
            - TZ=Europe/Brussels
            - HBOX_LOG_LEVEL=info
            - HBOX_LOG_FORMAT=text
            - HBOX_WEB_MAX_UPLOAD_SIZE=10
        ports:
            - '3100:7745'
        restart: unless-stopped
        container_name: homebox

Veillez à changer votre TIMEZONE (TZ):

- TZ=Europe/Brussels => Changer Europe/Brussels par ce qui vous correspond.

On installe l'application:

docker-compose up -d

ou avec docker-compose V2:

docker compose up -d

Rendez-vous sur l'ip:port, suivant l'IP de votre serveur local et du port choisi:

http://ip:3100

👤 Création du compte admin

Lorsque vous lancez HomeBox pour la première fois, il faudra créer un compte administrateur. Cliquez sur Register:

Remplissez les informations demandées:

Set your email? => Choisissez un e-mail.
What's your name => Choisissez un pseudo, un nom.
Set your password => Choisissez un mot de passe fort.

Cliquez sur Register, vous devriez avoir un message de ce type si tout s'est bien passé:

Vous serez redirigé vers la page de connexion, entrez vos informations de compte et cliquez sur Login:

Vous voilà sur le tableau de bord principal:

💶 Format de devise

Pour choisir votre devise, cliquez sur Profile et dans la partie Group Settings, choisissez votre devise, cliquez sur Update Group quand vous avez terminé: