Grafana: 4. Create the service

This documentation is part of the Automate with the CLI guide. You can view the complete guide here: Start Grafana, retrieve its credentials, and modify its configuration programmatically using the Stackhero CLI.

👋 Welcome to the Stackhero documentation!

Stackhero provides you with a ready-to-use Grafana cloud environment, designed for rapid deployment and reliable performance:

• Unlimited users, dashboards, and alerts: scale your monitoring as required, with no artificial restrictions.
• A dedicated SMTP email server is included, allowing you to send as many notifications as you need, with no quotas to monitor.
• One-click plugin installation makes it easy to add new features to Grafana.
• Built-in SSO support for GitLab, GitHub, Google, and any generic OAuth2 provider. User management remains straightforward and secure.
• One-click updates ensure your Grafana instance stays up to date, with no downtime or maintenance headaches.
• Use your own custom domain with automated HTTPS provisioning for secure, branded access (for example, https://grafana.your-company.com).
• High performance and enhanced security come as standard, running on your own private, dedicated infrastructure.

Get started more quickly and save time on setup: a secure Grafana cloud hosting instance is ready in around 5 minutes.

Below is an example script that creates a stack, adds your Grafana service to it, waits for it to start, retrieves its configuration (including generated credentials), and then applies a new configuration.

#!/bin/bash
set -e

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

serviceStore="grafana"   # The Grafana service store name (see step 2)
instance="..."                # An instance size from step 3
region="europe"               # A region name from step 3

# Create a stack for your service (uses your default organisation; add --organization if needed)
stackId=$(stackhero --format=script stack-create \
  --name="My Grafana stack")
echo "Stack created: ${stackId}"

# Add Grafana to the stack (names are resolved automatically)
serviceId=$(stackhero --format=script service-add \
  --stack="My Grafana stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service added: grafana"

# Wait for the service to be fully operational (this may take a few minutes)
stackhero service-wait-for --service="grafana"

# Retrieve the service configuration, including generated credentials
stackhero service-configuration-get --service="grafana" --format=json