Installation

This is another installation which I first installed on Container Manager in my Synology NAS, then to a Portainer Stack and then on to a simple Docker Compose file via SSH to my minipc server. Every migration was done seamlessly without loss of data.

1. First change directory to your Docker folder (I keep all containers in a Docker folder). Add a folder called homebox.heimdall. Change directory to the homeboxheimdall and add a folder called config. Move back to the Heimdall 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 homeboxheimdall
  cd /docker/homeboxheimdall
  sudo mkdir config
  cd /docker/heimdall
  sudo nano docker-compose.yml

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

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.