Mercure-Hub: 4. Create the service
This documentation is part of the Automate with the CLI guide. You can view the complete guide here: Start Mercure Hub, retrieve its credentials, and modify its configuration programmatically using the Stackhero CLI.
👋 Welcome to the Stackhero documentation!
Stackhero offers a fully managed Mercure-Hub cloud service, designed to simplify and ensure reliable real-time data delivery. You benefit from:
- Unlimited requests and message sizes for complete flexibility.
- A custom domain with integrated HTTPS security (for example, https://real-time.your-company.com).
- One-click updates to keep your hub up to date effortlessly.
- High performance and enhanced security on a private, dedicated infrastructure.
- Multiple available regions: 🇪🇺 Europe and 🇺🇸 USA for low-latency delivery.
Get started quickly: it takes just 5 minutes to launch your Mercure-Hub cloud hosting environment and start sending real-time updates to your applications.
Below is an example 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 organisation; 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 operational (this may take a few minutes)
stackhero service-wait-for --service="mercure-hub"
# Retrieve the service configuration, including generated credentials
stackhero service-configuration-get --service="mercure-hub" --format=json