Subdomains let you host additional sites or services under your main domain — like shop.example.com, api.example.com, or staging.example.com.
Before You Start
- You need an active hosting account with its main domain set up
- The subdomain must be under your main domain — you can't create
example.comas a subdomain ofyouraccount.com
Creating a Subdomain
- In Hosting Mode, go to Domains → Subdomains
- Click New Subdomain
- Enter the subdomain name (just the prefix — e.g.,
shop, notshop.example.com) - The document root is pre-filled:
public_html/shop/— change it if you need a different folder name - Select the PHP version (defaults to your account's current version)
- Click Create
The Agent creates the Nginx vhost for shop.example.com, a PHP-FPM pool (sharing the account user's socket configuration), and adds a DNS A record pointing to the server IP.
Document Root
By default, shop.example.com is served from:
/home/{username}/{domain.com}/public_html/shop/
If the shop/ folder doesn't exist yet, the Agent creates it with a placeholder index.html.
You can set a custom path — for example, if you want a Laravel app that lives at /home/user/domain.com/laravel-app/ with its public/ as the web root, set the document root to laravel-app/public.
See Document Root Structure for the full file layout.
PHP Version per Subdomain
Each subdomain can run a different PHP version than the main domain. After creating the subdomain, go to PHP → [subdomain] to change its version. See Switching PHP Version.
SSL for Subdomains
Let's Encrypt issues certificates per domain. After creating a subdomain, go to SSL and issue a certificate for it. See Issuing Certificates.
[!TIP] If you issue a wildcard certificate (
*.example.com) for the main domain, subdomains are automatically covered. Wildcard certs require DNS-01 challenge verification.
Deleting a Subdomain
In Hosting Mode, go to Domains → Subdomains, find the subdomain, and click Delete. The Agent removes the vhost and DNS record. Files in the document root folder are not deleted — they stay on disk in case you need them.