Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Download the Gumband OS Monitor zip file at the bottom of this page, and extract its contents to put in a place that is unlikely to be touched.

  • Create an exhibit in the Gumband UI, and get an exhibit token and id.

  • Add a .env file to the same directory that the gumband-os-monitor-linux-x64 file is and add the exhibit token and id from the previous step:

    Code Block
    EXHIBIT_TOKEN=02b6903aece21b6sff520ac92dcba457
    EXHIBIT_ID=1
    
    # If the Gumband UI you're connecting to is not app.gumband.com, you'll 
    # need to add two more environment variables here:
    # ENDPOINT=custom               <----- indicates a custom IP
    # CUSTOM_IP=other.gmbnd.com     <----- defines an endpoint that isn't app.gumband.com
  • Give the gumband-os-monitor-linux-x64 file execution permission with chmod +x gumband-os-monitor-linux-x64

  • Create a script to run the os monitor from systemd: vi startup.sh

Code Block
#!/bin/sh

//This value may differ depending on the host machine
export DISPLAY=:0;

cd /path/to/gumband-os-monitor;
./gumband-os-monitor-linux-x64
  • Make that script executable: chmod +x startup.sh

  • Create a systemd daemon for this user with

...

Code Block
[Unit]
Description=Gumband OS Monitor
[Service]
Type=simple
TimeoutStartSec=0
ExecStart=bash /path/to/startup/script
[Install]
WantedBy=default.target
  • Enable the daemon with: systemctl --user enable gumband-os-monitor.service

  • Ensure that scrot is installed (a linux, command-line screenshot application). Run which scrot to check if it is installed.

...

  • Reboot the PC. When it boots up, the OS Monitor should show as online in the Gumband UI:

    Image Removed

...

Troubleshooting

...

  • .

...

This problem occurs because the os-monitor doesn’t have access to the $DISPLAY environment variable, since it is running as a daemon. To fix this, add the environment variable to the daemon through your startup.sh script:

...

Zip Download

View file
namegumband-os-monitor-linux-x64

...