Skip to main content

Installation

Installation is with Docker Compose.

  1. With a terminal SSH connection to your server, change directory to your Docker folder (I keep all containers in a Docker folder). Add a folder called glances. Change directory to the glances 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 glances
  cd /docker/glances
  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:glances:
    container_name: glances  
    image: ghcr.io/sysadminsmedia/homebox:latestnicolargo/glances:ubuntu-latest-full    
    container_name: homebox
  restart: unless-stopped
  environment:ports:
      - HBOX_LOG_LEVEL=info7300:61208    
    - HBOX_LOG_FORMAT=text
     - HBOX_WEB_MAX_UPLOAD_SIZE=10
     - HBOX_OPTIONS_ALLOW_REGISTRATION=true #can change to false after first time registrationenvironment:
      - TZ=America/Santo_Domingo
      - GLANCES_OPT= -w --password # Glances option to run as a web server
    pid: host    
    restart: unless-stopped    
    volumes:
      - ./homebox:var/run/docker.sock:/data/
  ports:
     - 3100:7745
     
volumes:
  homebox:
   driver: localvar/run/docker.sock:ro
  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 homeboxglances in your internet browser with:

        http://<local ip address>:31007300

  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