Node.js: 4. Create the service

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

👋 Welcome to the Stackhero documentation!

Stackhero delivers a ready-to-use Node.js cloud environment designed to help you move faster:

• Deploy to production in seconds with a simple git push. No extra tooling or manual setup is required.
• Bring your own domain and benefit from automatic HTTPS certificates, keeping your application secure without extra configuration.
• Automatic backups, one-click updates, and predictable pricing help you focus on shipping features, and Stackhero manages the infrastructure for you.
• Built on private, dedicated infrastructure for consistent performance and strong security.

Save time and reduce operational overhead: you can have your application running on Stackhero's Node.js cloud hosting in just a few minutes.

Here is a sample script that creates a stack, adds your Node.js 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="node-js"   # The Node.js 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 Node.js stack")
echo "Stack created: ${stackId}"

# Add Node.js to the stack (names are resolved automatically)
serviceId=$(stackhero --format=script service-add \
  --stack="My Node.js stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service added: node-js"

# Wait for the service to be fully running (this may take a couple of minutes)
stackhero service-wait-for --service="node-js"

# Retrieve the service configuration, including generated credentials
stackhero service-configuration-get --service="node-js" --format=json