Skip to main content


After hyperglass is installed, you can run the hyperglass --help command to see the available options:

$ hyperglass --help
Usage: hyperglass [OPTIONS] COMMAND [ARGS]...
hyperglass Command Line Interface
-v, --version ๐Ÿ”ข hyperglass version
-h, --help ๐Ÿ™ Show this help message
build-ui ๐Ÿฆ‹ Create a new UI build
clear-cache ๐Ÿงผ Clear the Redis cache
secret ๐Ÿ”’ Generate agent secret
setup ๐Ÿงฐ Run the setup wizard
start ๐Ÿš€ Start web server

Setup Wizard#

To start the setup wizard, run hyperglass setup.

You'll receive the following prompts:

Installation Directory#

[?] Choose a directory for hyperglass: /Users/ml/hyperglass
> /home/user/hyperglass

hyperglass requires a directory on your system to store configuration files, the web UI, logos, etc. You may choose between the current user's home directory or /etc (use the up/down arrow keys).

UI Build#

After running the setup, the build-ui command needs to be run for the first time. This command creates the required file structure for the UI, initializes frontend dependencies, and generates favicons.


If your system's compute resources are too low, the build-ui step will likely fail. You can use the --timeout flag to increase the default timeout of 180 seconds. You can also set the environment variable HYPERGLASS_UI_BUILD_TIMEOUT for the same result. See the system requirements section for more information about system resources.

$ hyperglass build-ui
โœ… Completed UI build in production mode


To start hyperglass from the console run hyperglass start.


hyperglass won't start without a devices.yaml file. See the Adding Devices section for instructions on how add devices.

$ hyperglass start

Remember to check the Production section for instructions on how to run hyperglass in production. It includes instructions and examples for setting up a Reverse Proxy (such as NGINX or Caddy), and running hyperglass as a system service with systemd.