Mercure-Hub: 1. Authenticate

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

👋 Welcome to the Stackhero documentation!

Stackhero provides a fully managed Mercure-Hub cloud service designed to make real-time data delivery simple and reliable. You get:

• Unlimited requests and message sizes for complete flexibility.
• A custom domain with built-in HTTPS security (for example, https://real-time.your-company.com).
• Effortless one-click updates to keep your hub up to date with zero hassle.
• High performance and strong security on a private, dedicated infrastructure.
• Multiple regions: 🇪🇺 Europe and 🇺🇸 USA for low-latency delivery.

Get up and running fast: it takes just 5 minutes to launch your Mercure-Hub cloud hosting environment and start pushing real-time updates to your applications.

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"