forked from mirrors/thatmattlove-hyperglass
82 lines
2.3 KiB
Text
82 lines
2.3 KiB
Text
---
|
|
id: setup
|
|
title: Setup
|
|
sidebar_label: Setup
|
|
keywords: [install, setup]
|
|
description: hyperglass Setup
|
|
---
|
|
|
|
import Link from "@docusaurus/Link";
|
|
|
|
After hyperglass is [installed](getting-started.mdx), you can run the `hyperglass --help` command to see the available options:
|
|
|
|
```shell-session
|
|
$ hyperglass --help
|
|
Usage: hyperglass [OPTIONS] COMMAND [ARGS]...
|
|
|
|
hyperglass Command Line Interface
|
|
|
|
Options:
|
|
-v, --version 🔢 hyperglass version
|
|
-h, --help 🙏 Show this help message
|
|
|
|
Commands:
|
|
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
|
|
|
|
```shell-session
|
|
[?] Choose a directory for hyperglass: /Users/ml/hyperglass
|
|
> /home/user/hyperglass
|
|
/etc/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`.
|
|
|
|
### Systemd Service
|
|
|
|
```shell-session
|
|
Do you want to generate a systemd service file? [y/N]:
|
|
```
|
|
|
|
hyperglass also includes a [systemd](https://systemd.io/) service file, which can be installed if you use systemd. If selected, a systemd service file will be generated and copied to the installation directory. Then, it will be symlinked to `/etc/systemd/system`. All you need to do to enable the service is run:
|
|
|
|
```shell-session
|
|
$ sudo systemctl enable hyperglass
|
|
```
|
|
|
|
## 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.
|
|
|
|
:::note
|
|
If your system's compute resources are too low, the `build-ui` step will likely fail. See the [system requirements](production.mdx) section for more information.
|
|
:::
|
|
|
|
```shell-session
|
|
$ hyperglass build-ui
|
|
✅ Completed UI build in development mode
|
|
```
|
|
|
|
## Startup
|
|
|
|
To start hyperglass at the console run `hyperglass start`.
|
|
|
|
:::important
|
|
hyperglass won't start without a `devices.yaml` file. See the [Adding Devices](adding-devices.mdx) section for instructions on how add devices.
|
|
:::
|
|
|
|
```shell-session
|
|
$ hyperglass start
|
|
```
|