Installation

My first installation was with the Synology Container Manager, from there I moved it to a Portainer Stack. My mode of installation now though is SSH to my minipc and use Docker Compose. I found that is the easiest way to run my Docker Containers and keep the necessary data persistence. If I lost my Homebox data now, I would be more than a little upset.

1. First change directory to your Docker folder (I keep all containers in a Docker folder). Add a folder called homebox. Change directory to the homebox directory and then add a docker-compose file. To do this, the following four command lines should be entered into the command line separately:

  cd /docker
  sudo mkdir homebox
  cd /docker/homebox
  sudo nano docker-compose.yml

2. Once the nano editor is open, add the docker compose lines below:

               **The appropriate TZ can be found with the command in this link -> command to find your time zone, TZ.

services:
  homebox:
  image: ghcr.io/sysadminsmedia/homebox:latest
  container_name: homebox
  restart: unless-stopped
  environment:
     - HBOX_LOG_LEVEL=info
     - HBOX_LOG_FORMAT=text
     - HBOX_WEB_MAX_UPLOAD_SIZE=10
     - HBOX_OPTIONS_ALLOW_REGISTRATION=true #can change to false after first time registration
     - TZ=America/Santo_Domingo
  volumes:
     - ./homebox:/data/
  ports:
     - 3100:7745
     
volumes:
  homebox:
   driver: local

3. Press Ctrl-O and then enter to save the file. Ctrl-X to exit the Nano editor.
4. Then start the container with the following command:

sudo docker compose up -d

5. You can now enter homebox in your internet browser with:

        http://<local ip address>:3100

6. Register as a first time user, with your new password.
7. I wanted to be the only user, so after I registered, I stopped the container, changed the HBOX_OPTIONS_ALLOW_REGISTRATION line to false, and then started the container again. That made me the only user, and no one else could sign up.