myron
1675de36eb
Five markdown documents covering the full panel: - docs/README.md: index with links to all guides - docs/install.md: requirements, one-liner install, file layout, config.ini, auto-deploy, upgrade - docs/admin-guide.md: all admin panel sections (accounts, DNS, mail, security, Docker, notifications, WHMCS) - docs/reseller-guide.md: account management, white-label branding, Docker quotas - docs/user-guide.md: files, email, databases, FTP, DNS, SSL, cron, Docker, settings - docs/api-reference.md: all 25+ endpoints with request/response shapes, auth, rate limits, role access Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
3.5 KiB
NovaCPX — Reseller Guide
Accessing the Reseller Panel
The reseller panel runs on port 8881. Navigate to https://<server-ip>:8881 and log in with your reseller credentials.
Your admin will provide your username and initial password.
Overview
As a reseller you can create and manage hosting accounts for your customers. You only see accounts assigned to you — other resellers' accounts are hidden. The admin can see all accounts.
Accounts
Creating a customer account
Accounts → Create Account
| Field | Notes |
|---|---|
| Username | Lowercase, alphanumeric. Unique on the server. |
| Domain | Primary domain. DNS zone and web vhost created automatically. |
| Customer's email. Receives welcome notification (if enabled). | |
| Password | Min 8 characters. |
| Package | Resource limits. Available packages are defined by your admin. |
| PHP version | PHP-FPM version for this account. |
Managing accounts
From Accounts, you can:
- Suspend — disables the customer's website
- Unsuspend — re-enables it
- Change Password — reset the customer's panel and system password
You cannot terminate accounts — contact your admin if an account needs to be removed.
Domains
Under each account you can:
- Add addon domains (additional websites on the same account)
- Add subdomains
- Add redirects
- View the document root for each domain
Manage virtual email addresses for your customers' domains:
- Create mailboxes (username@domain.com)
- Set passwords
- Suspend / reactivate mailboxes
- Set storage quotas
Customers access their email via the webmail interface at port 8883, or by configuring an email client with the server's hostname.
Webmail SSO
Customers can be redirected to webmail with a single-sign-on link from the user panel. The SSO token is valid for 5 minutes.
DNS
View and edit DNS records for accounts you manage. Standard record types are supported (A, AAAA, CNAME, MX, TXT, etc.). Changes are applied live via rndc reload.
Databases
Create and manage MySQL databases for your customers. Each database is prefixed with the account username to avoid conflicts.
FTP
Create FTP accounts scoped to specific directories of an account. Useful for giving customers access to subdirectories without full SSH.
Docker
If Docker is enabled on the server, you can:
- View containers running under your customers' accounts
- Set per-customer Docker quotas (max containers, RAM, CPU)
- Launch one-click app catalog deployments on behalf of a customer
White Label
White Label lets you brand the reseller panel and user panel with your own identity.
| Setting | Notes |
|---|---|
| Panel Name | Replaces "NovaCPX" in the panel header |
| Logo | Upload a PNG/JPG/SVG (max 512 KB) |
| Favicon | Small icon shown in browser tabs |
| Primary Color | Main accent color (hex) |
| Accent Color | Secondary color (hex) |
| Support Email | Shown in customer-facing error messages |
| Support URL | Link in the panel footer |
| Hide "Powered by NovaCPX" | Suppress the footer attribution |
| Custom CSS | Inject additional CSS into all panel pages |
Changes take effect immediately for new page loads.
Customers logging in
Your customers log in to the user panel at port 8880. Give them:
- URL:
https://<server-ip>:8880 - Their username and password (set when you created their account)
From the user panel they can manage their own files, email, databases, FTP accounts, DNS records, SSL certificates, and cron jobs.