Matomo: 1. Authenticate

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

👋 Welcome to the Stackhero documentation!

Stackhero offers a Matomo cloud solution that simplifies web analytics:

• Unlimited websites, members, segments, goals, and data retention: analyze everything you need, for as long as you need it.
• Effortless updates: keep your analytics platform up to date with just one click.
• Custom domain name with HTTPS: run Matomo on a secure, branded URL, for example https://analytics.your-company.com.
• High performance and enhanced security: your data is hosted on private, dedicated infrastructure to ensure reliability and confidentiality.

With Stackhero, you can deploy Matomo analytics in just a few minutes and manage all your sites from a single location. Try our Matomo cloud hosting to simplify your analytics and focus on what matters most.

The simplest way to get started is to log 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 directly into the CLI.

stackhero login

After logging in, your credentials are stored locally and will be used automatically by future 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"