dsync89 Wiki

Appearance

HomeBox ​

HomeBox is used to manage home inventory. Great for OCD like me to keep track of all the stuffs I ever owned, and it even count the total asset values!

alt text

Install ​

We will deploy it using docker-compose.

Go to Docker, then select Add New Stack. alt text

alt text

alt text

Next we will create a docker-compose file.

alt text

Paste the following

TIP

We mount homebox data folder to the unRAID host path /mnt/user/appdata/homebox.

version: "3.4"

services:
  homebox:
    image: ghcr.io/hay-kot/homebox:latest
#   image: ghcr.io/hay-kot/homebox:latest-rootless
    container_name: homebox
    restart: always
    environment:
    - HBOX_MODE=production
    - HBOX_WEB_PORT=7745
    - HBOX_OPTIONS_ALLOW_REGISTRATION=true
    - HBOX_LOG_LEVEL=info
    - HBOX_LOG_FORMAT=text
    - HBOX_WEB_MAX_UPLOAD_SIZE=100
    volumes:
      - /mnt/user/appdata/homebox:/data/
    ports:
      - 3100:7745

Click Save Changes button when done.

alt text

Scroll to the top and you should see a newly created homebox container.

alt text

Check if files that homebox is using are written to your unRAID host path at /mnt/user/appdata/homebox.

alt text

Login ​

alt text

Register user

alt text

Login

alt text

Dashboard

alt text

Import CSV ​

You can even import CSV! See https://hay-kot.github.io/homebox/import-csv/ for more info.

alt text

Here is an example:

alt text

These are the columns I used.

HB.name	HB.purchase_price	HB.purchase_from	HB.manufacturer	HB.model_number	HB.serial_number	HB.purchase_time	HB.location	HB.labels	HB.quantity	HB.description	HB.notes	HB.field.purchase_platform	HB.field.purchase_from_url	HB.field.purchase_item_url	HB.field.payment_card_num	HB.import_ref	HB.asset_id	HB.archived	HB.insured	HB.lifetime_warranty	HB.warranty_expires	HB.warranty_details	HB.sold_to	HB.sold_price	HB.sold_time	HB.sold_notes

TIP

I created several additional custom fields to satisfy my OCD:

  • HB.field.purchase_platform: Which e-Commerce platform I purchased from, e.g. Amazon, Shoppee
  • HB.field.purchase_from_url: The URL where I purchase from the seller
  • HB.field.purchase_item_url: The URL of the item (official)
  • HB.field.payment_method: The payment method I used, e.g. PayPal, Credit Card, Debit Card, Bank Transfer
  • HB.field.payment_card_num: The last 4 digit of the credit card used to purchase

Customization ​

You can select different theme.

alt text

Too bad it doesn't support New Taiwan Dollar... Issue created at https://github.com/hay-kot/homebox/issues/918

alt text