Deploying and Provisioning Client Hosting Accounts

📌 Purpose & Quick Summary

The User Management center (index.php?page=manage_users) allows you to provision, configure, and oversee all end-user customer accounts under your reseller brand. When you deploy a client account, BoostonCP automatically creates an isolated Linux user environment, sets up cgroups v2 resource boundaries, initializes a private document root (public_html), assigns isolated PHP-FPM pools, and grants the customer full access to their dedicated User Panel on Port 2083.

Figure 2: Reseller User Management ledger showing account provisioning form, search filters, and client accounts.

🖥️ Interface Tour & Elements

1. Deploy Client Account Form: Located at the top of the page, allowing rapid provisioning:
   • Username Input: Client account identifier (e.g. cybernode). Must be unique across the entire server node.
   • Email Address: Client contact email for automated alerts and password resets.
   • Password Input: Cryptographic password with 1-click Generate Password sync button.
   • Package Dropdown: Selects from your authorized reseller hosting packages (e.g. Starter, Business).
   • Deploy Button: Initiates instantaneous asynchronous account provisioning.
2. Account Filter Tabs:
   • All Users: Displays all active and suspended client accounts.
   • Active: Filters for healthy accounts in good standing.
   • Suspended: Filters for accounts disabled due to non-payment or policy violations.
3. Search & Resource Filters:
   • Search Input: Instant live filter by username, email, or primary domain.
   • Resource Usage Filter: Filter clients by High Disk (>=80%), Medium Disk, High Bandwidth (>=80%), or Low Usage.
4. Client Accounts Ledger Table: Displays Username, Primary Domain, Assigned Package, Disk Space Bar, Bandwidth Meter, Account Status, and Contextual Actions.

🛠️ Step-by-Step Instructions

Step 1: Deploying a New Client Account

1. In the sidebar, click Users (icon: fa-users).
2. In the Deploy Client Account form:
   • Username: Enter a unique username containing lowercase letters and numbers (e.g. novashop).
   • Email Address: Enter the customer's email (e.g. [email protected]).
   • Password: Click the Generate Password (sync icon) button to create a high-entropy password, and copy it to a secure location.
   • Package: Choose an appropriate hosting package from the dropdown.
3. Click the Deploy button.
4. The system executes background provisioning in ~3 seconds:
   • Linux user and group creation.
   • Home directory provisioning (/home/novashop/public_html).
   • Assigning quota parameters (cgroups v2 and disk quotas).
   • Injecting nameservers and generating welcome credentials.

Step 2: Searching and Filtering Client Accounts

1. Use the Search accounts... field to instantly find any user by typing partial names.
2. Click the Resource Usage dropdown and select High Disk (>=80%) to identify customers nearing their storage limit.

⚙️ Complete Field & Parameter Reference Table

❓ Troubleshooting & Common Errors

1. Error: "Username already exists on the server"

• Cause: The chosen username is already registered by another account on this BoostonCP server node.
• Solution: Choose an alternative username (e.g. append numbers or initials: novashop2).

2. Error: "Reseller account quota exceeded"

• Cause: You have reached the maximum number of user accounts permitted by your reseller tier (e.g. 10/10).
• Solution: Terminate obsolete test accounts or contact your hosting provider to expand your reseller account allocation.