📌 Purpose & Quick Summary
The Packages builder (index.php?page=packages) allows you to package server resources into tiered hosting products (e.g. Bronze, Silver, Gold, E-Commerce Pro) that you sell to your clients. You can set exact disk storage ceilings, monthly bandwidth allowances, maximum permitted domains, subdomains, MySQL databases, FTP accounts, and email mailboxes, tailoring packages to different customer segments.
Figure 3: Package Configuration Modal showing resource quota fields, domain limits, and feature toggles.
🖥️ Interface Tour & Elements
- Plan Configuration Modal:
- Package Name: Custom marketing title (e.g. Business Cloud).
- Disk Quota (MB): Maximum disk storage permitted for this package (e.g.
5120 MBfor 5GB). - Monthly Bandwidth (MB): Transfer allowance (e.g.
50000 MBfor 50GB). - Max Domains: Number of distinct top-level websites the client can host.
- Max Subdomains: Maximum subdomain VirtualHosts (
sub.domain.com). - Max MySQL Databases: Database allowance for CMS installations.
- Max FTP Accounts: Secondary FTP logins allowed.
- Max Email Mailboxes: POP3/IMAP mailbox accounts.
- Feature Access Toggles: Selective checkboxes to enable or disable advanced tools (Terminal, File Manager, Backup Master, DNS Editor).
🛠️ Step-by-Step Instructions
Step 1: Launching the Package Creator
- In the sidebar, click Packages (icon:
fa-box-open). - Click the Create New Package button at the top-right.
- The Plan Configuration Modal opens.
Step 2: Defining Resource Limits
- In Package Name, type
Starter Shared. - In Disk Quota, enter
2048(2 GB). - In Bandwidth, enter
20480(20 GB). - In Max Domains, enter
1. - In Max Subdomains, enter
5. - In Max MySQL Databases, enter
2. - In Max Email Accounts, enter
5.
Step 3: Configuring Feature Access
- Review the Enabled Features checkboxes.
- Check features your client tier is permitted to use (e.g. File Manager, Backups, Email, SSL, 1-Click Install).
- If this is an entry-level tier, leave Terminal unchecked to prevent shell access.
- Click Save Package. The plan is registered and immediately appears in the User Deployment package dropdown.
⚙️ Complete Field & Parameter Reference Table
| Package Parameter | Unit of Measure | Recommended Value (Starter) | Technical Enforcement |
|---|---|---|---|
| Package Name | Text string | Standard / Pro |
Visible in client control panel and WHMCS billing sync. |
| Disk Quota | Megabytes (MB) | 2048 MB (2 GB) |
Enforced via Linux xfs/ext4 filesystem quotas on /home/user. |
| Bandwidth | Megabytes (MB) | 25000 MB (25 GB) |
Enforced via Nginx access log accounting daemon. |
| Max Domains | Integer count | 1 to 5 |
Enforced when client clicks "Add Domain" in User Panel. |
| Max Databases | Integer count | 2 to 10 |
Enforced when client provisions MariaDB relational assets. |
| Max Emails | Integer count | 5 to 25 |
Enforced when client provisions Postfix/Dovecot mailboxes. |
❓ Troubleshooting & Common Errors
1. "Create New Package" Button Missing
- Cause: Your parent reseller subscription was configured with package creation permissions disabled by the server administrator.
- Solution: Contact your hosting provider to verify that
allow_package_creationis enabled on your reseller account.