Mercure-Hub: 4. Create the service
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.
Here is a sample script that creates a stack, adds your Mercure Hub service to it, waits for it to start, retrieves its configuration (including generated credentials), and then applies a new configuration.
#!/bin/bash
set -e
export STACKHERO_TOKEN="usr-xxxxxx:your-token"
serviceStore="mercure-hub" # The Mercure Hub service store name (see step 2)
instance="..." # An instance size from step 3
region="europe" # A region name from step 3
# Create a stack for your service (uses your default organization; add --organization if needed)
stackId=$(stackhero --format=script stack-create \
--name="My Mercure Hub stack")
echo "Stack created: ${stackId}"
# Add Mercure Hub to the stack (names are resolved automatically)
serviceId=$(stackhero --format=script service-add \
--stack="My Mercure Hub stack" \
--service-store="${serviceStore}" \
--instance="${instance}" \
--region="${region}")
echo "Service added: mercure-hub"
# Wait for the service to be fully running (this may take a couple of minutes)
stackhero service-wait-for --service="mercure-hub"
# Retrieve the service configuration, including generated credentials
stackhero service-configuration-get --service="mercure-hub" --format=json