Grafana: 1. Authenticate

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.

The simplest way to get started is to log in via your browser. When you run the login command, the CLI opens a web page where you can approve access. No passwords or 2FA codes are entered into the CLI itself.

stackhero login

Once logged in, your credentials are stored locally and will be used automatically by subsequent CLI commands.

For fully automated environments such as scripts or CI pipelines, you may prefer a non-interactive access token. You can create one from your dashboard (Account > Access tokens), then export it as an environment variable. The CLI, as well as any script you run, will automatically detect it.

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