Matomo: 1. Authenticate

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

👋 Welcome to the Stackhero documentation!

Stackhero provides a Matomo cloud solution that streamlines web analytics:

• Unlimited websites, members, segments, goals, and data retention: track everything you need, for as long as you need it.
• Effortless updates: keep your analytics platform current with a single click.
• Custom domain name with HTTPS: run Matomo at a secure, branded URL, such as https://analytics.your-company.com.
• High performance and strong security: your data runs on private, dedicated infrastructure for reliability and privacy.

With Stackhero, you can launch Matomo analytics in minutes and manage all your sites from one place. Try our Matomo cloud hosting to simplify analytics and focus on what matters.

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"