Skip to main content

Installation

MyInstallation first installation was with the Synology Container Manager, from there I moved it to a Portainer Stack. My mode of installation now though isvia SSH to my minipcserver and usethen creating and running a Docker Compose.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.file.

  1. First change directory to your Docker folder (I keep all containers in a Docker folder). Add a folder called homebox.guacamole. Change directory to the homeboxguacamole 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 homeboxguacamole
  cd /docker/homeboxguacamole
  sudo nano docker-compose.yml
  1. 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:guacamole:
    container_name: guacamole
    image: ghcr.io/sysadminsmedia/homebox:latest
  container_name: homeboxjwetzell/guacamole
    restart: unless-stopped
    environment:ports:
     - 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_Domingo8562:8080
    volumes:
     - ./homebox:guacamole:/data/config
    ports:environment:
      -TZ: 3100:7745America/Santo_Domingo
      volumes:EXTENSIONS: homebox:
   driver: local"auth-totp"
  1. Press Ctrl-O and then enter to save the file. Ctrl-X to exit the Nano editor.
  2. Then start the container with the following command:
sudo docker compose up -d
  1. You can now enter homeboxguacle in your internet browser with:

        http://<local ip address>:31008562

  1. Register as a first time user, with your new password.
  2. 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.
Back to top