Grafana: 1. Authenticate

This documentation is part of the Automate with the CLI guide. View the full guide here: Start Grafana, retrieve its credentials, and change its configuration programmatically with the Stackhero CLI.

👋 Welcome to the Stackhero documentation!

Stackhero gives you a ready-to-use Grafana cloud environment built for quick setup and reliable performance:

• Unlimited users, dashboards, and alerts: scale your monitoring as needed, without artificial limits.
• Dedicated SMTP email server included, so you can send all the notifications you want, with no quotas to track.
• One-click plugin installation streamlines adding new features to Grafana.
• Built-in SSO support for GitLab, GitHub, Google, and any generic OAuth2 provider. User management stays simple and secure.
• One-click updates keep your Grafana instance current, with no downtime or maintenance hassle.
• Use your own custom domain with automated HTTPS provisioning for secure, branded access (for example, https://grafana.your-company.com).
• High performance and strong security are standard, running on your own private, dedicated infrastructure.

Get started faster and save setup time: a secure Grafana cloud hosting instance is ready in about 5 minutes.

The easiest way to get started is by logging in through 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

After logging in, your credentials are stored locally and will be used automatically by future CLI commands.

For fully automated environments like scripts or CI pipelines, you might 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, and any script you run, will pick it up automatically.

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