Getting Started

Everything you need to prepare before running sp setup — VPS, domain, and DNS.

Step 1 — Choose a VPS

ServicePlus runs on any Linux VPS. The minimum requirement is Ubuntu 22.04 LTS with at least 2 GB RAM and 20 GB SSD storage. See the VPS Guide for exact tier recommendations based on your expected usage.

Tier	RAM	CPU	Best for
Starter	2–4 GB	2 vCPU	Freelancers, solo professionals
Growth	4–8 GB	2–4 vCPU	Small agencies, growing teams
Agency	8–16 GB	4+ vCPU	Active agencies, multiple clients

We recommend Hostinger — affordable VPS plans with beginner-friendly setup. Use code GOLDCOUPON at checkout for 20% off. Choose the closest region to your clients for best speed.

After provisioning your VPS, note down the public IP address — you will need it in the next step to configure DNS.

Step 2 — Point your domain & configure subdomains

ServicePlus deploys each service on its own subdomain under your main domain. You need to configure DNS records before running sp setup — SSL certificates are issued automatically during setup, but only if DNS is already pointing to your server.

Option A — Individual subdomain records (recommended)

Add each subdomain manually as its own A record. This is more reliable than a wildcard — wildcard records sometimes fail to propagate correctly or get overridden by provider defaults:

Type	Name	Value
A	`yourdomain.com`	Your VPS IP (Mautic public pages)
A	`dash.yourdomain.com`	Your VPS IP (Mautic admin dashboard)
A	`ai.yourdomain.com`	Your VPS IP (for n8n)
A	`cal.yourdomain.com`	Your VPS IP (for Cal.com)
A	`pb.yourdomain.com`	Your VPS IP (for PocketBase)
A	`db.yourdomain.com`	Your VPS IP (for Adminer)

Option B — Wildcard DNS record

A wildcard record (*.yourdomain.com) covers all subdomains automatically, including ones you add later with sp add.

In your DNS provider, add these two records:

Type	Name	Value	TTL
A	`@` or `yourdomain.com`	Your VPS IP	300
A	`*`	Your VPS IP	300

DNS propagation can take up to 30 minutes (sometimes up to 2 hours with some providers). Before running sp setup, verify your domain resolves correctly:

bash

# Check that your domain points to your VPS IP
nslookup yourdomain.com
# or
dig yourdomain.com +short

The output should show your VPS IP address. If it shows a different IP or no result, wait and try again.

Which DNS provider?

If you registered your domain with a Moroccan registrar (e.g. RegistreMaroc, MTDS) or an international one (Namecheap, GoDaddy, Cloudflare), you manage DNS in their control panel.

How to connect to your VPS via SSH

If you are new to VPS hosting, here is how to connect to your server from your local machine:

bash

# Replace 1.2.3.4 with your VPS IP
# Replace ubuntu with your VPS username (often "root" or "ubuntu")
ssh ubuntu@1.2.3.4

Your VPS provider sends you the IP address, username, and either a password or an SSH key when the server is created. Use that to log in. Once connected, all sp commands run in this terminal.

Checklist before continuing

VPS is running Ubuntu 22.04+ with at least 2 GB RAM and 20 GB SSD
You can SSH into the server
Your domain's A record and wildcard subdomain point to the VPS IP
DNS has propagated — nslookup yourdomain.com shows your IP
You have a valid ServicePlus license key from aimad.net/sp-buy-key

Once all boxes are checked, continue to the next step.

Download the CLI