sp setup

Deploy your full ServicePlus stack for the first time.

Usage

bash
sp setup

Optional flags — pin specific versions

By default, ServicePlus auto-detects and installs the latest stable version of Mautic and MySQL. If you need a specific version (e.g. to match an existing deployment or avoid a known issue in a newer release), pass it explicitly:

bash
# Pin a specific Mautic version
sp setup --mautic-v 6.3.1

# Pin a specific MySQL version
sp setup --mysql-v 8.0.36

# Pin both
sp setup --mautic-v 6.3.1 --mysql-v 8.0.36
The version tag you provide is validated against Docker Hub before setup continues. If the tag does not exist, the CLI will warn you and let you choose a valid one. The resolved version is stored in your encrypted config so future commands stay consistent.

What it does

sp setup is the main deployment command. It guides you through an interactive wizard that provisions your entire stack from scratch.

Setup wizard steps

  1. License verification — validates your serial key online
  2. Project name — short identifier used for container naming
  3. Domain — your base domain (subdomains are auto-configured)
  4. Admin email — for the Mautic admin account and Let's Encrypt SSL
  5. Master password — encrypts your local configuration file
  6. Security question & answer — used for password recovery only
Store your master password and security answer offline. They cannot be recovered through support. If lost, you will need to run sp cleanup and set up again.

What setup provisions automatically

  • Docker and Docker Compose (if not present)
  • MySQL database container
  • Mautic 6 container with full configuration
  • Apache reverse proxy with virtual hosts
  • Let's Encrypt SSL certificates via Certbot
  • ServicePlus plugin bundle injection
  • GeoIP automatic weekly update cron
  • Encrypted configuration stored at ~/.serviceplus/config.enc
Setup typically takes 3–8 minutes on a fresh server with a good internet connection.

After setup

bash
# View access URLs and credentials
sp cred

# Check all services are healthy
sp status

# Add optional services
sp add n8n
sp add calcom

Best practices

  • Run setup as root or a user with sudo access
  • Make sure DNS is already pointed at your server before starting
  • Do not interrupt setup midway — if it fails, run sp cleanup first, then retry
CLI Overviewsp status