Mercure-Hub: 6. Change the configuration

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.

You can review an example configuration schema and then apply your own settings. When you update the configuration, the service may restart to apply the changes.

# View the configuration schema and an example for your service
stackhero service-configuration-example --service=svc-xxxxxx

# Apply a custom configuration (the service restarts if needed)
stackhero service-configuration-set \
  --service=svc-xxxxxx \
  --configuration='{ "...": "..." }'

# Wait for the new configuration to be applied
stackhero service-wait-for --service=svc-xxxxxx

That is it. You have now seen the full lifecycle: start a service, retrieve its credentials, and reconfigure it, all in a scriptable, automated way. To dive deeper, check out the full CLI documentation, which also covers the non-interactive STACKHERO_TOKEN authentication demonstrated here.