--- title: How to install Hyperglance on your own Instance or VM description: If you need to install Hyperglance on your own hardened/golden VM, follow these instructions --- [Skip to content](https://support.hyperglance.com/knowledge/installing-hyperglance-on-your-own-instance-or-vm#main-content) English Show submenu for translations [More support](https://support.hyperglance.com/knowledge/kb-tickets/new?hsLang=en) ![](https://support.hyperglance.com/hs-fs/hubfs/hyperglance.png?width=100&height=75&name=hyperglance.png) Open main navigation Close main navigation - English Show submenu for translations - [More support](https://support.hyperglance.com/knowledge/kb-tickets/new) - [Contact Us](https://www.hyperglance.com/contact/) [Contact Us](https://www.hyperglance.com/contact/) How can we help you? - There are no suggestions because the search field is empty. 1. [Hyperglance Support](https://support.hyperglance.com/knowledge?hsLang=en) 2. [Setup & Configuration](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en) 3. [General](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#general) # How to install Hyperglance on your own Instance or VM ## If you need to install Hyperglance on your own hardened/golden VM, follow these instructions The Hyperglance installer uses the Hyperglance CLI to install on your remote instance. The installer has been tested against: - Amazon Linux 2023 - Alma Linux 9 - RHEL (Red Hat Enterprise Linux) 9 - Rocky Linux  9 - Ubuntu 22.04 (LTS) & Ubuntu 24.04 (LTS) Please use one of these distributions. #### General Pre-Requisites (Local) 1. **Docker** Installed and Running on your **LOCAL** system. We ship updates to the Hyperglance cli via docker containers and docker hub. 2. SSH access to the deployment target to upload the installer and associated tooling. If using the `hg install remote` command, you will also need the SSH private key and user that has root permissions. #### General Pre-Requisites (Remote / Deployment Target) 1. The Hyperglance CLI will require access to the internet. The installer reaches out to a number of locations to acquire all the components for both the Kubernetes runtime (RKE2) as well as any pre-requisites. Deployment instructions Install Remotely To Host 1. Pull and run the latest Hyperglance CLI container. Replace `PATH_TO_SSH_KEY` with the correct path to the ssh you will use to connect to the remote instance. ``` docker run --rm -it --pull always -v PATH_TO_SSH_KEY:/app/key.pem hyperglance/updatetool:latest ``` This will place you in the containers bash shell. 2. \[Optional\] Test connectivity and provided user credentials against the remote host. Replace `SERVER_IP`, `YOUR_USERNAME` and `SSH_PORT` with the correct values. The --key can remain as-is as we mapped it to this in the previous command. ``` hg install remote --address SERVER_IP --username YOUR_USERNAME --port SSH_PORT --key key.pem --test ``` Example usage and successful connection is shown below: ``` root@47aeb54424fb:/app# hg install remote --address 44.201.49.121 --username ubuntu --port 22 --key key.pem --testThe authenticity of host '44.201.49.121 (44.201.49.121)' can't be established.ED25519 key fingerprint is SHA256:unsW4k+ROzCHbpg/YRimFr1DjgZ4UufRAkGJhaVhbkg.This key is not known by any other namesAre you sure you want to continue connecting (yes/no/[fingerprint])? yes[INFO] Connectivity and permissions test passed! ``` 3. Run the installation. Replace `SERVER_IP`, `YOUR_USERNAME` and `SSH_PORT` with the correct values. The --key can remain as-is as we mapped it to this in the previous command. ``` hg install remote --address SERVER_IP --username YOUR_USERNAME --port SSH_PORT --key key.pem --confirm ``` 4. A successful run will show ``` [INFO]    _____ _    _  _____ _____ ______  _____ _____ _   / ____| |  | |/ ____/ ____|  ____|/ ____/ ____| | | (___ | |  | | |   | |    | |__  | (___| (___ | |  \___ \| |  | | |   | |    |  __|  \___ \\___ \| |  ____) | |__| | |___| |____| |____ ____) |___) |_| |_____/ \____/ \_____\_____|______|_____/_____/(_)Please wait while the remote instance is rebooted. ``` Install Directly On Remote Host 1. Pull the latest Hyperglance CLI container, and extract the CLI and related tooling.   ``` docker create --name hg_cli hyperglance/updatetool:latest && \docker cp hg_cli:/app/. ./ && \docker rm hg_cli && \rm ./upgrade.sh ``` This will extract:  1. hg 2. hg-cli-updater 3. hg-cli-log-viewer 4. ansible-playbook.pyz 2. Upload these files to your own vm and place them under the `/usr/local/bin` directory. 3. Ensure these are all executable: ``` sudo chmod +x /usr/local/bin/hg /usr/local/bin/hg-cli-updater /usr/local/bin/hg-cli-log-viewer /usr/local/bin/ansible-playbook.pyz ``` 4. Start the installation: ``` sudo /usr/local/bin/hg install local --accept ``` 5. A Successful run will show: ``` [INFO]  _____ _    _  _____ _____ ______  _____ _____ _  / ____| |  | |/ ____/ ____|  ____|/ ____/ ____| | | (___ | |  | | |   | |    | |__  | (___| (___ | | \___ \| |  | | |   | |    |  __|  \___ \\___ \| | ____) | |__| | |___| |____| |____ ____) |___) |_| |_____/ \____/ \_____\_____|______|_____/_____/(_)Please reboot to finalise the installation. ``` 6. Reboot ``` sudo reboot now ``` **DONE!** Hyperglance should now be available using the IP / DNS Name of the host.  Apply the Hyperglance licence: https://support.hyperglance.com/knowledge/how-to-apply-a-new-license.     - [Before You Start](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#main-content) - [Kubernetes](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#kubernetes) - [GCP](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#gcp) - [AWS](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#aws) - [Azure](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#azure) - [Using Hyperglance](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#main-content) - [Automations](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#automations) - [Inventory & Diagrams](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#inventory-diagrams) - [Rules](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#rules) - [Cost Management](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#cost-management) - [Dashboards](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#dashboards) - [Security & Compliance](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#security-compliance) - [Setup & Configuration](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#main-content) - [Updating & Migrating](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#updating-migrating) - [General](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#general) - [RBAC & Users](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#rbac-users) - [STIGS & FIPS](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#stigs-fips) - [AWS](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#aws) - [Azure](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#azure) - [Kubernetes](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#kubernetes) - [GCP](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#gcp) - [API](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#api) - [Legacy Docker-based deployments](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#legacy-docker-based-deployments) - [AI](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#ai) [![Chill listening crop-3](https://support.hyperglance.com/hs-fs/hubfs/hyperglance.png?width=134&height=24&name=hyperglance.png "Chill listening crop-3")](https://www.hyperglance.com/) 2880 Zanker Road, Suite 203, San Jose, CA 95134 Copyright © 2025 Hyperglance. All rights reserved.