Homebox is the inventory and organization system built for the Home User! With a focus on simplicity and ease of use, Homebox is the perfect solution for your home inventory, organization, and management needs. In this step by step guide I will show you how to install Homebox on your UGREEN NAS using Docker & Portainer.

💡Note: This guide works perfectly with the latest Homebox v0.14.2 release.

• STEP 1

Please Support My work by Making a Donation.

• STEP 2

Install Portainer using my step by step guide. If you already have Portainer installed on your UGREEN NAS, skip this STEP. Attention: Make sure you have installed the latest Portainer version.

• STEP 3

Add Read & Write Permissions to the Docker Folder. If you have already added the Read and Write Permissions to the Docker Folder, skip this STEP.

• STEP 4

Go to File Manager and open the docker folder. Inside the docker folder, create one new folder and name it homebox. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

• STEP 5

Log into Portainer using your username and password. On the left sidebar in Portainer, click on Stacks then + Add stack. Follow the instructions in the image below.

• STEP 6

In the Name field type in homebox. Follow the instructions in the image below.

Note: Copy Paste the code below in the Portainer Stacks Web editor.

version: "3.9"
services:
  homebox:
    container_name: Homebox
    image: ghcr.io/sysadminsmedia/homebox:latest
    mem_limit: 3g
    cpu_shares: 1024
    security_opt:
      - no-new-privileges:true
    restart: on-failure:5
    ports:
      - 3100:7745
    volumes:
      - /volume1/docker/homebox:/data:rw
    environment:
       HBOX_LOG_LEVEL: info
       HBOX_LOG_FORMAT: text
       HBOX_WEB_MAX_UPLOAD_SIZE: 5000
       TZ: Europe/Bucharest

Note: Before you paste the code above in the Web editor area below, change the value for TZ. (Select your current Time Zone from this list.)

• STEP 7

Scroll down on the page until you see a button named Deploy the stack. Click on it. Follow the instructions in the image below. The installation process can take up to a few minutes. It will depend on your Internet speed connection.

• STEP 8

If everything goes right, you will see the following message at the top right of your screen: “Success Stack successfully deployed“.

• STEP 9

Go back to STEP 1 or you will deal with karma 🙂

• STEP 10

The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Now open your browser and type in http://ugreennas-ip-address:3100 Click Register. Follow the instructions in the image below.

• STEP 11

Type in your own credentials: Email Address, Name and Password. Click Register. Follow the instructions in the image below.

• STEP 12

Type in your own Email Address and Password that you have previously created at STEP 11, then click Login. Follow the instructions in the image below.

• STEP 13

On the left sidebar, click Profile to personalize your user profile. Follow the instructions in the image below.

• STEP 14

On the left sidebar, click on Tools to generate different reports and import/export your inventory. Follow the instructions in the image below.

• STEP 15

Your Homebox at a glance!

Enjoy Homebox on your UGREEN NAS!

This post was updated on Sunday / September 15th, 2024 at 8:27 AM