Install Dependencies
To install hyperglass manually, you'll need to install the following dependencies:
- Python 3.9, 3.10, 3.11, or 3.12 (opens in a new tab) and
pip
(opens in a new tab) - NodeJS 18.17 or later (opens in a new tab)
- PNPM 8 or later (opens in a new tab)
- Redis 7.2 or later (opens in a new tab)
ā ļø
Make sure the Redis server is started.
Install hyperglass
Once these dependencies are installed, install hyperglass via PyPI:
pip3 install hyperglass
Create app directory
If you plan on using a different directory, be sure to set the directory you wish to use in your environment variables.
mkdir /etc/hyperglass
Optional: Quickstart
Do this if you just want to see the hyperglass page working with default settings and a fake device.
curl -o /etc/hyperglass/devices.yaml https://raw.githubusercontent.com/thatmattlove/hyperglass/v2.0.0/.samples/sample_devices.yaml
hyperglass start
Create a systemd
service
curl -o /etc/hyperglass/hyperglass.service https://raw.githubusercontent.com/thatmattlove/hyperglass/v2.0.0/.samples/hyperglass-manual.service
ln -s /etc/hyperglass/hyperglass.service /etc/systemd/system/hyperglass.service
systemctl daemon-reload
systemctl enable hyperglass
systemctl start hyperglass
If you used a different app directory from the default /etc/hyperglass
, change the
EnvironmentFile
value in the hyperglass.service
file.