Documentation

Everything you need to know about installing and managing WisPanel on your servers.

Domain Management

Domain Management

Manage your web domains, configure DNS, SSL certificates, and optimize performance directly from WisPanel.

Adding a Domain

  1. Click Add Domain button
  2. Enter domain name (e.g., example.com)
  3. Choose domain type:
    • Main Domain: Primary domain for account
    • Addon Domain: Additional domain pointing to different folder
    • Subdomain: Subdomain under existing domain
  4. Select or create document root folder
  5. Click Create

Domain Settings

Document Root

  • Click Browse to select folder
  • Default: /home/username/public_html
  • Ensure folder exists and is writable

PHP Version

  1. Open domain settings
  2. Select PHP version from dropdown:
    • PHP 7.4, 8.0, 8.1, 8.2, 8.3
    • System Default (recommended)
  3. Click Apply
  4. Changes take effect immediately

SSL Certificate

  1. Navigate to SSL tab
  2. Options:
    • Let's Encrypt: Free auto-renewing certificate
    • Self-Signed: For testing/private use
    • Upload Custom: Use your own certificate
  3. Configure auto-renewal if using Let's Encrypt

HTTPS Redirect

  1. Open domain settings
  2. Toggle Force HTTPS
  3. All HTTP traffic redirects to HTTPS
  4. Check Permanent Redirect (301) for SEO

WWW Redirect

  1. Choose redirect type:
    • No redirect
    • Redirect www to non-www
    • Redirect non-www to www
  2. Apply changes

Custom Error Pages

  1. Click Error Pages
  2. Upload custom HTML for:
    • 404 Not Found
    • 403 Forbidden
    • 500 Server Error
    • 503 Service Unavailable
  3. Save configuration

Hotlink Protection

  1. Enable Hotlink Protection
  2. Whitelist domains that can hotlink
  3. Specify file extensions to protect (.jpg, .png, etc.)
  4. Set referrer replacement image (optional)

Advanced Features

DNS Management

  1. View nameservers for domain
  2. Update A, CNAME, MX, TXT records
  3. Configure subdomains via DNS

Domain Pointers

  1. Add alternative domain names pointing to same content
  2. Useful for brand variations
  3. All pointers share same folder and configuration

Redirects

  1. Create permanent (301) or temporary (302) redirects
  2. Redirect old domain to new domain
  3. Redirect specific paths

HSTS (HTTP Strict Transport Security)

  1. Enable HSTS header
  2. Set max-age duration (31536000 = 1 year)
  3. Include subdomains option
  4. Preload option for HSTS preload list

FastCGI Cache

  1. Enable caching for static content
  2. Configure cache duration
  3. Whitelist dynamic pages (admin, cart, etc.)
  4. Test cache effectiveness

Vhost Editor

  1. Click Edit Vhost
  2. Modify Apache/Nginx configuration directly
  3. Add custom rules, redirects, headers
  4. Be careful with syntax
  5. Test configuration before saving

Management Operations

Suspend Domain

  1. Right-click domain
  2. Click Suspend
  3. Domain becomes inaccessible
  4. Can be resumed later

Delete Domain

  1. Backup files and databases first
  2. Right-click domain > Delete
  3. Confirm deletion
  4. Choose to delete files and/or databases
  5. Cannot be undone

Regenerate Vhost

  1. If configuration becomes corrupted
  2. Right-click > Regenerate Vhost
  3. System rebuilds vhost file
  4. Service restarts automatically

View Statistics

  1. Domain stats show bandwidth usage
  2. Requests per day
  3. Error rates
  4. Performance metrics

Troubleshooting

Domain not accessible:

  • Check DNS propagation (24-48 hours)
  • Verify document root exists
  • Check file permissions

SSL certificate errors:

  • Ensure domain is publicly accessible
  • Let's Encrypt validation requires HTTP access
  • Check firewall/port forwarding

PHP not working:

  • Verify PHP version is selected
  • Check file permissions
  • Review PHP error logs

[Screenshot: domain-management.png] [Screenshot: domain-settings.png] [Screenshot: ssl-configuration.png]