--- title: "Quickstart Guide" description: "" url: "https://docs.itrsgroup.com/docs/geneos/7.11.0/getting-started/quickstart/index.html" --- ## Overview Geneos can be deployed in a variety of ways to meet your specific business needs. Here are the basic steps to get started with Geneos in any environment. ## Standard environment (Linux and Windows) To install Geneos on a Linux or Windows environment, please follow these steps. 1. Verify that you have met all of the prerequisites listed below. Then, check your License Daemon to make sure that you have the appropriate licenses for the Geneos components that you want to use. - [Operating System support](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/licence-daemon/index.html#operating-system-support) - [Installation considerations](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/licence-daemon/index.html#installation-considerations) - [Required libraries](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/licence-daemon/index.html#required-libraries) 2. Download and install the Licence Daemon. - [Extracting files](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/licence-daemon/index.html#extracting-files) - [Providing the Licence File](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/licence-daemon/index.html#providing-the-licence-file) 3. Run your Licence Daemon. - [Executing](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/licence-daemon/index.html#executing) - [Required libraries](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/netprobe/installation/quickstart-linux-and-other-platforms/index.html#required-libraries) 4. Ensure that the Gateway prerequisites are met, then run the Gateway setup. - [Gateway System Requirements](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/gateway_installation_guide/index.html#gateway-system-requirements) - [How to download and unpack Gateway](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/gateway_installation_guide/index.html#how-to-download-and-unpack-gateway) - [How to create a start script for Gateway](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/gateway_installation_guide/index.html#how-to-create-a-start-script-for-gateway) - [How to start and configure the Gateway](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/gateway_installation_guide/index.html#how-to-start-and-configure-the-gateway) 5. Ensure that the Active Console prerequisites are met, then run the Active Console setup. - [System Requirements](https://docs.itrsgroup.com/docs/geneos/7.11.0/visualization/active-console/system-requirements/index.html) - [Download binaries](https://docs.itrsgroup.com/docs/geneos/7.11.0/visualization/active-console/download-and-setup/index.html#download-binaries) - [Connect to a Gateway](https://docs.itrsgroup.com/docs/geneos/7.11.0/visualization/active-console/download-and-setup/index.html#connect-to-a-gateway) 7. [Connect the Active Console to the Gateway](https://docs.itrsgroup.com/docs/geneos/7.11.0/visualization/active-console/download-and-setup/index.html#connect-the-active-console-to-the-gateway). 8. Run your Netprobe. 9. Connect your Netprobe to your Gateway. - Download and install the Netprobe. - For Linux, [Download the Netprobe files](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/netprobe/installation/quickstart-linux-and-other-platforms/index.html#download-the-netprobe-files) and [Install a new Netprobe](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/netprobe/installation/quickstart-linux-and-other-platforms/index.html#install-a-new-netprobe). - For Windows, [Download the Netprobe files](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/netprobe/installation/quickstart-windows/index.html#download-the-netprobe-files) and [Install a new Netprobe](https://docs.itrsgroup.com/docs/geneos/7.11.0/collection/netprobe/installation/quickstart-windows/index.html#install-a-new-netprobe). - In the Active Console, open the Gateway Setup Editor of your running Gateway. - Navigate to **Probes** > **New Probe**. - Supply the Netprobe name. - Supply the host and port from the previous step, and then apply the changes. 10. Add samplers. For more information, see [Samplers](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/configuration/gateway_samplers/index.html). 11. Add Managed Entities. For more information, see [Managed Entities and Managed Entity Groups](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/configuration/gateway_managed_entities/index.html). 12. View your metrics in the metrics dockables. For more information, see [Metrics Dockable](https://docs.itrsgroup.com/docs/geneos/7.11.0/visualization/active-console/view-customization/metrics-dockable/index.html). ## Amazon Web Services Cloud If you want to deploy the Geneos binaries on AWS, do the following: 1. Verify that all [Geneos prerequisites](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/geneos-aws-cloud/index.html#geneos-prerequisites) are met. 2. Verify that all [Amazon Web Services EC2 system requirements](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/geneos-aws-cloud/index.html#amazon-web-services-ec2-system-requirements) are met. 3. Deploy an EC2 instance. Geneos supports the Operating Systems found in the [Compatibility Matrix](https://docs.itrsgroup.com/docs/all/geneos/7x-geneos-compat-matrix/index.html). 4. Download and transfer the Geneos binaries to the running EC2 instance [through SSH](https://docs.itrsgroup.com/docs/geneos/7.11.0/processing/geneos-aws-cloud/index.html). 5. Perform the Install, Run, and Connect steps found in the [Standard Environment](#Standard) section. Alternately, you can deploy an EC2 instance that contains a Netprobe with an AWS plugin by [launching the ITRS Geneos EC2 instance](https://docs.itrsgroup.com/docs/geneos/collection/aws-cloudwatch/current/user-guide/aws-marketplace/index.html). This deployment also allows you to gather and monitor metrics through AWS Cloudwatch. For more information, see [AWS](https://docs.itrsgroup.com/docs/geneos/collection/aws-cloudwatch/current/user-guide/aws/index.html). ## Azure You can deploy the pre-configured ITRS virtual machine through the Azure Marketplace. 1. Verify that all [Geneos prerequisites](https://docs.itrsgroup.com/docs/geneos/collection/azure-monitor/current/user-guide/azure-monitor/index.html#prerequisites) are met. 2. Verify that all [Azure prerequisites](https://docs.itrsgroup.com/docs/geneos/collection/azure-monitor/current/user-guide/azure-monitor/index.html#prerequisites) are met. 3. [Create a virtual machine in the Azure Marketplace](https://docs.itrsgroup.com/docs/geneos/collection/azure-monitor/current/user-guide/azure-monitor/index.html). 4. Download and transfer the Geneos binaries to the running virtual machine. 5. Perform the installation steps found in the [Standard Environment](#Standard) section. Alternately, you can deploy an Azure virtual machine that has the Azure Monitor plugin and the Azure Event Hub plugin by following [Deploy Azure through the Azure Marketplace](https://docs.itrsgroup.com/docs/geneos/collection/azure-monitor/current/user-guide/azure-monitor/index.html#deploy-azure-through-the-azure-marketplace-1). ## Docker containers Gateway, Netprobe, and Webserver are also available as Docker images that can be run as containers. To do this: 1. Verify that all [prerequisites](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/geneos_containers/index.html#prerequisites) are met. 2. [Download the Docker images from the ITRS Docker registry](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/geneos_containers/index.html#install). See [Docker available versions](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/geneos_containers/index.html#available-versions) for more information. The Gateway image config is read from the `/gateway/config/gateway.gci`. See [Gateway: Alternative Gateway configuration and setup files](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/geneos_containers/index.html#gateway-configuration) to use an alternative configuration. The Netprobe image config is read from the `/netprobe/config/netprobe.gci`. See [Netprobe: Alternative Netprobe configuration and setup files](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/geneos_containers/index.html#netprobe-configuration) to use an alternative configuration. The Webserver image config is read from `/webserver/config`. See [Webserver: Alternative Webserver configuration and setup files](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/geneos_containers/index.html#webserver-configuration). ## Kubernetes using Helm 1. Verify that all [Helm prerequisites](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/installation-using-helm/index.html#helm-prerequisites) are met. 2. [Create a namespace](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/installation-using-helm/index.html#create-a-namespace) and [Install a Helm chart](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/installation-using-helm/index.html#install-a-helm-chart). 3. If you want to deploy your Netprobe via Helm, follow any of these steps: - [DaemonSet deployment](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/installation-using-helm/index.html#daemonsetdeployment) — to monitor full metrics and events in all namespaces using a DaemonSet (EC2-backed clusters only). - [Non-DaemonSet deployment](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/installation-using-helm/index.html#non-daemonsetdeployment) — to monitor full metrics and events in all namespaces without using a DaemonSet. **Note** For Fargate-only EKS clusters, see [Amazon EKS Fargate compatibility](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/aws-eks-fargate-compatibility/index.html) for more information. 4. If you want to deploy your Gateway via Helm, follow any of these steps: - [Insecure installation](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/installation-using-helm/index.html#insecure-installation) — install Gateway in your cluster without TLS security. - [Secure installation](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/installation-using-helm/index.html#secure-installation) — install Gateway in your cluster with TLS security. You can also connect your Gateway to ITRS Analytics, see [Connecting to ITRS Analytics](https://docs.itrsgroup.com/docs/geneos/7.11.0/administration/orchestrated-environments/installation-using-helm/index.html#connecting-to-itrs-analytics).