Initial Setup

Run sp setup to deploy your full stack with one command.

Before you run setup

Make sure:

  • Your domain's A record points to your VPS IP and DNS has propagated
  • Port 80 and 443 are open on your server firewall
  • The ServicePlus CLI is installed (sp version should work)
  • You have your serial key ready

Run the setup command

bash
sp setup

The CLI will guide you through an interactive setup. You will be asked for:

  1. Serial key — your SP-XXXX-XXXX-XXXX-XXXX license key
  2. Project name — a short identifier for your deployment (e.g. myagency)
  3. Domain — your main domain (e.g. marketing.mybusiness.ma)
  4. Admin email — used for the Mautic admin account and SSL certificate
  5. Master password — protects your encrypted configuration; do not lose this
  6. Security question & answer — used for password recovery
Write down your master password and security answer and store them somewhere safe. They are not recoverable if lost.

What setup does automatically

Once you answer the prompts, sp setup handles everything else:

  • Verifies and activates your license
  • Installs Docker and Docker Compose if not already present
  • Pulls and starts all service containers
  • Provisions HTTPS certificates via Let's Encrypt (Certbot)
  • Configures Apache as a reverse proxy for all services
  • Installs and activates the ServicePlus plugin bundle on Mautic
  • Configures GeoIP automatic updates
  • Saves encrypted configuration to your server
Setup typically takes 3–8 minutes depending on your server speed and internet connection.

After setup completes

When setup finishes, the CLI prints a summary with your access URLs and credentials. Save this output before closing your terminal session.

You can retrieve your credentials at any time with:

bash
sp cred

Adding optional services

Core Mautic + MySQL + SSL are installed by default. To add n8n, Cal.com, or PocketBase later:

bash
sp add n8n
sp add calcom
sp add pocketbase

See the sp add reference for full details.