Installation & updating
Get up and running in minutes
Before installing groundcover, please make sure your cluster meets the requirements.
Sign up to groundcover
The first thing you need to do to start using groundcover is sign up using your email address (no credit card required for the free tier account). Signing up is only possible using a computer and will not be possible using a mobile phone or tablet. It is highly recommended you use your corporate email address, as it will make it easier to use other features such as inviting your colleagues to your workspace. However, signing up using Gmail, Outlook or any other public domains is also possible.
After signing up, you can install groundcover using any one of these methods:
Installing using our UI
When signing in to groundcover for the first time, the platform automatically detects your organization based on the domain you used to sign in. If your organization already has existing workspaces available, the workspace selection screen will be displayed, where you can choose which of the existing workspaces you would like to join, or if you want to create a new workspace.
Available workspaces will be displayed only if either of the following applies:
You have been invited to join existing workspaces and haven't joined them yet
Someone has previously created a workspace that has auto-join enabled for the email domain that you used to sign in (applicable for corporate email domains only)

To join an existing workspace:
Click the Join button next to the desired workspace
You will be added as a user to that workspace with the user privileges that were assigned by default or those that were assigned to you specifically when the invite was sent.
You will automatically be redirected to that workspace.
To create a new workspace:
Click the Create a new workspace button
Specify a workspace name
Choose whether to enable auto-join (those settings can be changed later)
Click continue

Copy the command line displayed on the screen using the Copy Command button (Note: This is not your API key)
Open your CLI
Paste the command line in your CLI (Note: Make sure your kubectl context is pointing to the desired cluster)
The installation screen will open automatically and will let you know on-screen when the installation has completed.

Within 10 minutes after installation completes, all of your cluster's data will appear in your workspace.

Enabling Auto-join for a new or existing Workspace
Workspace owners and admins can allow teammates that log in with the same email domain as them to join the Workspace they created automatically, without an admin approval. This capability is called "Auto-join". It is disabled by default, but can be switched on during the workspace set up process, or any time in the workspace settings.
If you logged in with a public email domain (Gmail, Yahoo, Proton, etc.) and are creating a new Workspace, you will not be able to switch on Auto-join for that Workspace.
Installing using a CLI
Use groundcover CLI to automate the installation process. The main advantages of using this installation method are:
Auto-detection of cluster incompatibility issues
Tolerations setup automation
Tuning of resources according to cluster size
It supports passing helm overrides
Automated detection of new versions and upgrades suggestions
Read more here.
Installing groundcover CLI
sh -c "$(curl -fsSL https://groundcover.com/install.sh)"
Deploying groundcover using the CLI
groundcover deploy
------
# If you need to provide configuration values from a values.yaml file:
groundcover deploy -f values.yaml
Installing using Helm
groundcover can be installed using the official helm chart.
If you’re interested in installing the helm chart using a CI/CD solution, such as ArgoCD, make sure you read our CI/CD installation section as well.
# Make sure you have groundcover CLI installed
# Make sure you have created an Ingestion-Key of type Sensor (Settings -> Access -> Ingestion-Keys)
# (1) Login to your groundcover account
groundcover auth login
# (3) Make sure groundcover Helm repoistory is present (once)
helm repo add groundcover https://helm.groundcover.com
# (4) Update groundcover Helm repository to fetch latest charts
helm repo update groundcover
# (5) Deploy groundcover release
helm upgrade \
groundcover \
groundcover/groundcover \
-i \
--create-namespace \
-n groundcover \
--set global.groundcover_token={ingestion-key},clusterId={cluster-name}
------
# If you need to provide configuration values from a values.yaml file:
# (5*) Deploy groundcover release
helm upgrade \
groundcover \
groundcover/groundcover \
-i \
--create-namespace \
-n groundcover \
--set global.groundcover_token={ingestion-key},clusterId={cluster-name} \
--values values.yaml
What can you do next?
Set up your first alert
Set up your first dashboard
Invite your colleagues
Installing groundcover on additional clusters
Adding more clusters
groundcover can monitor multiple clusters, and new clusters can be added at any given time. You can add new clusters using the UI.
Click on the cluster picker in the top right corner and then on the + Add Cluster
option.
Updating groundcover
To update the groundcover agent to the latest version:
Using CLI
groundcover deploy
------
# If you need to provide configuration values from a values.yaml file:
groundcover deploy -f values.yaml
Using Helm
# Make sure you have groundcover CLI installed
# Make sure you have created an Ingestion-Key of type Sensor (Settings -> Access -> Ingestion-Keys)
# (1) Login to your groundcover account
groundcover auth login
# (3) Make sure groundcover Helm repoistory is present (once)
helm repo add groundcover https://helm.groundcover.com
# (4) Update groundcover Helm repository to fetch latest charts
helm repo update groundcover
# (5) Deploy groundcover release
helm upgrade \
groundcover \
groundcover/groundcover \
-i \
--create-namespace \
-n groundcover \
--set global.groundcover_token={ingestion-key},clusterId={cluster-name}
------
# If you need to provide configuration values from a values.yaml file:
# (5*) Deploy groundcover release
helm upgrade \
groundcover \
groundcover/groundcover \
-i \
--create-namespace \
-n groundcover \
--set global.groundcover_token={ingestion-key},clusterId={cluster-name} \
--values values.yaml
Uninstalling
groundcover delete
Last updated