Documentation
Complete guides and references to help you set up and manage your email and web hosting with WebDNS.
Email Hosting - Getting Started
Welcome to WebDNS. Follow these steps to set up your professional email hosting:
- Create an account - Register for an account and choose an email hosting plan that suits your needs.
- Add your domain - Enter your domain name in the dashboard.
- Configure DNS records - Follow the guided DNS setup to point your domain to our mail servers.
- Create mailboxes - Set up email accounts for your team.
- Start sending email - Connect your preferred email client or use the built-in Webmail in your dashboard.
Adding Your Domain (Email)
To use your own domain for email, you need to configure the following DNS records at your domain registrar:
| Record Type | Host | Value | Purpose |
|---|---|---|---|
| MX | @ | Your mail server hostname | Routes email to our servers |
| TXT | @ | v=spf1 include:... ~all | SPF - Authorises our servers to send on your behalf |
| TXT | dkim._domainkey | Provided in your dashboard | DKIM - Email signing for authenticity |
| TXT | _dmarc | v=DMARC1; p=quarantine; ... | DMARC - Policy for handling unauthenticated email |
| CNAME | autoconfig | Your mail server hostname | Automatic email client configuration |
| SRV | _autodiscover._tcp | Your mail server hostname | Outlook automatic setup |
Your dashboard provides the exact values for each record. After adding the records, click "Verify DNS" in your dashboard to confirm everything is configured correctly. DNS changes can take up to 24 hours to propagate.
Creating Mailboxes
Once your domain is verified, you can create mailboxes for your team:
- Navigate to Mailboxes in your customer dashboard.
- Click Create Mailbox.
- Enter the desired email address (e.g., [email protected]).
- Set a display name and a secure password.
- Click Create to provision the mailbox.
The mailbox is created instantly and ready to use. Each mailbox comes with its own storage quota as defined by your plan.
Email Client Configuration
Configure your preferred email client with the following settings:
Incoming Mail (IMAP)
| Server | Your mail server hostname |
| Port | 993 |
| Encryption | SSL/TLS |
| Username | Your full email address |
| Password | Your mailbox password |
Outgoing Mail (SMTP)
| Server | Your mail server hostname |
| Port | 587 (STARTTLS) or 465 (SSL/TLS) |
| Encryption | STARTTLS or SSL/TLS |
| Username | Your full email address |
| Password | Your mailbox password |
| Authentication | Required |
POP3 (Alternative)
| Server | Your mail server hostname |
| Port | 995 |
| Encryption | SSL/TLS |
Tip: If your domain has autoconfig and autodiscover DNS records configured, most modern email clients (Outlook, Thunderbird, Apple Mail) will automatically detect these settings.
Managing Aliases
Email aliases allow you to create additional email addresses that forward to an existing mailbox. For example, you can create [email protected] as an alias that delivers to [email protected].
Creating an Alias
- Navigate to Aliases in your customer dashboard.
- Click Create Alias.
- Enter the alias address (e.g., [email protected]).
- Select the destination mailbox where emails should be delivered.
- Click Create.
Aliases do not have their own mailbox or storage. They simply forward incoming email to the destination mailbox. You can create multiple aliases pointing to the same mailbox.
Webmail Access
Our built-in webmail client lets you read, compose, and manage your emails directly from your browser. No software to install.
How to Connect
- Log in to your customer dashboard.
- Click the Webmail button in the sidebar.
- Select the mailbox you want to access.
- Enter the mailbox password (the password you set when creating the mailbox, not your account password).
- You are now connected. Your session stays active for 2 hours of inactivity.
Features
- Read, compose, reply, and forward emails
- View and download attachments with image previews
- Manage folders - move, delete, mark as read/unread
- Bulk actions - select multiple emails and delete, move, or mark them at once
- Empty Trash and Junk folders with one click
- Send attachments up to 2 MB per file
Security
Your mailbox password is encrypted and stored only in your browser session. It is never saved permanently. All connections to the mail server use SSL/TLS encryption. Email content is rendered in a sandboxed environment that blocks scripts and other potentially harmful content.
Troubleshooting
- Incorrect password error - Make sure you are entering the mailbox password, not your account login password.
- Session expired - After 2 hours of inactivity your session expires. Simply enter your password again to reconnect.
- Page refresh - The webmail will automatically reconnect if your session is still active.
Web Hosting - Getting Started
Our web hosting is powered by LiteSpeed and includes a full control panel built directly into your dashboard. Here is how to get started:
- Create an account - Register and choose a web hosting plan.
- Your account is provisioned automatically - Your hosting account, primary domain, and control panel access are set up instantly.
- Point your domain - Update your domain's A record to point to our server IP (shown in your dashboard).
- Upload your files - Use the built-in File Manager or connect via FTP.
- Go live - Issue a free SSL certificate and your site is ready.
Your hosting control panel is accessible from the sidebar under Hosting. From there you can manage files, domains, databases, FTP accounts, cron jobs, backups, and more.
File Manager
The built-in File Manager lets you manage your website files directly from your browser.
Features
- Browse and navigate your hosting directory structure
- Create new files and folders
- Edit files with the built-in code editor (syntax highlighting included)
- Upload files from your computer
- Download individual files
- Rename, move, copy, and delete files or folders
- Extract archive files (.zip, .tar.gz, .gz) directly on the server
- Set file permissions (chmod)
How to Access
- Go to Hosting in your dashboard sidebar.
- Click File Manager.
- Your document root is displayed by default. Navigate using the breadcrumb or folder list.
Tip: For large file transfers, consider using FTP instead. The File Manager is best for quick edits and small uploads.
Domains & SSL
Manage all your hosting domains and SSL certificates from the Domains section of your control panel.
Adding a Domain
- Go to Hosting > Domains.
- Click Add Domain.
- Enter the domain name (e.g., example.com).
- The domain is added to your hosting account and a document root folder is created automatically.
- Point the domain's A record to your server IP address (shown on the page).
SSL Certificates
Every domain can get a free Let's Encrypt SSL certificate:
- Go to Hosting > Domains.
- Click the SSL button next to your domain.
- Click Issue SSL. The certificate is issued and installed automatically.
- Certificates auto-renew before they expire.
PHP Version
You can set the PHP version for each domain individually. We support PHP 8.1, 8.2, 8.3, 8.4, and 8.5. To change the PHP version:
- Go to Hosting > Domains.
- Click the PHP dropdown next to your domain.
- Select the version you need. The change takes effect immediately.
MySQL Databases
Create and manage MySQL databases for your websites and applications.
Creating a Database
- Go to Hosting > Databases.
- Click Create Database.
- Enter a database name and a secure password.
- Click Create. Your database is ready to use immediately.
Connection Details
| Host | localhost |
| Port | 3306 |
| Username | Same as database name |
| Password | The password you set when creating the database |
Use these details in your application's configuration file (e.g., wp-config.php for WordPress).
Managing Data
You can manage your database tables and data using the built-in database manager accessible from the Databases page. Click the Manage button next to any database to open it.
FTP Accounts
FTP accounts let you upload and download files using any FTP client (FileZilla, WinSCP, Cyberduck, etc.).
Creating an FTP Account
- Go to Hosting > FTP Accounts.
- Click Create FTP Account.
- Enter a username, password, and the directory the account should have access to.
- Optionally set a disk quota.
- Click Create.
Connection Details
| Host | Your server IP or domain (shown in your dashboard) |
| Port | 21 |
| Protocol | FTP |
| Username | The username you created |
| Password | The password you set |
Each FTP account is restricted to its configured directory and cannot access files outside of it.
One-Click App Installer
Install popular web applications on any of your hosting domains in minutes. Our one-click installer handles everything — downloading files, creating databases, configuring settings, and setting up admin access.
Available Applications
| Application | Category | Description |
|---|---|---|
| WordPress | CMS | The world's most popular content management system. Installed with optimal LiteSpeed Cache settings for best performance. |
| Joomla | CMS | Flexible, extensible content management system for building websites and powerful online applications. |
| Drupal | CMS | Powerful open-source content management framework used by millions of websites and applications. |
| Grav | CMS | Modern flat-file CMS — no database required. Fast, simple, and flexible with a built-in admin panel. |
| PrestaShop | E-Commerce | Create your online store with the world's most customizable open-source e-commerce solution. |
| OpenCart | E-Commerce | Free, open-source online store management program with a professional and reliable foundation. |
| phpBB | Forum | The world's most widely used open-source bulletin board solution with a vast range of features. |
| Flarum | Forum | Simple, fast, and modern forum software that makes online discussion delightful. |
| Nextcloud | Cloud Storage | Self-hosted productivity platform with file sync, sharing, calendars, contacts, and more. |
| Matomo | Analytics | Privacy-focused web analytics platform. A powerful alternative to Google Analytics with full data ownership. |
| MediaWiki | Wiki | The wiki software that powers Wikipedia. Create collaborative knowledge bases and documentation sites. |
| Moodle | Education | The world's most popular open-source learning management system for educators and trainers. |
Installing an Application
- Go to Hosting > Apps in your dashboard.
- Click Install on the application you want.
- Select the domain and optionally specify an install path (e.g.
/blog,/shop, or leave empty for root). - Enter a site title, admin credentials, and admin email.
- For apps that require a database (most apps), database details are pre-filled automatically.
- Click Install. The installer will download files, create the database, and configure the application.
Once complete, you can log in to your app's admin panel directly from the dashboard using the single sign-on (SSO) button — no need to remember separate credentials.
Managing Installed Apps
From the Apps page you can:
- View all installed applications with their domains, versions, and install paths
- Log in to any app's admin panel with one click (SSO)
- Visit the live site directly
- Delete an installation (with options to remove files, database, or both)
Tips
- Each app shows the minimum PHP version it requires. You can change PHP versions per domain from Hosting > Domains.
- You can install multiple apps on the same domain using different paths (e.g. WordPress at
/and Matomo at/analytics). - Grav is the only app that does not require a database — it uses flat files for all content storage.
- For WordPress, the installer automatically configures LiteSpeed Cache for optimal performance.
Cron Jobs
Schedule automated tasks to run at specific times or intervals.
Creating a Cron Job
- Go to Hosting > Cron Jobs.
- Click Add Cron Job.
- Use the visual schedule builder to set when the job should run, or choose from common presets (every minute, hourly, daily, weekly, monthly).
- Enter the command to execute (e.g.,
php /home/user/public_html/cron.php). - Click Save.
Common Presets
| Every minute | * * * * * |
| Every 5 minutes | */5 * * * * |
| Hourly | 0 * * * * |
| Daily at midnight | 0 0 * * * |
| Weekly (Sunday) | 0 0 * * 0 |
| Monthly | 0 0 1 * * |
Cron jobs are synced directly to the server's crontab. Changes take effect immediately.
Backups
Create and restore backups of your website files and databases.
Creating a Backup
- Go to Hosting > Backups.
- Choose the backup type: Full (files + databases), Files Only, or Database Only.
- Click Create Backup. The backup is generated on the server.
- Once complete, you can download or restore the backup.
Restoring a Backup
- Go to Hosting > Backups.
- Find the backup you want to restore.
- Click Restore. Files and/or databases will be restored to the state captured in that backup.
Important: Restoring a backup will overwrite the current files and/or database content. Make sure you have a recent backup before restoring an older one.
PHP Settings
Customise PHP configuration on a per-domain basis. This is useful for applications that need specific PHP settings.
Available Settings
| Directive | Description | Default |
|---|---|---|
| upload_max_filesize | Maximum size for file uploads | 128M |
| post_max_size | Maximum size of POST data | 128M |
| max_execution_time | Maximum script execution time in seconds | 120 |
| max_input_time | Maximum time to parse input data in seconds | 120 |
| memory_limit | Maximum memory a script can use | 512M |
| max_input_vars | Maximum number of input variables | 10000 |
| display_errors | Show PHP errors on screen (not recommended for production) | Off |
| error_reporting | Level of error reporting | E_ALL & ~E_NOTICE |
Changing PHP Settings
- Go to Hosting > Domains.
- Click the PHP Settings button next to the domain.
- Adjust the values as needed.
- Click Save. Changes take effect immediately.
Error & Access Logs
View your website's error logs and access logs to diagnose issues and monitor traffic.
Error Logs
Error logs show PHP errors, warnings, and notices generated by your website. To view them:
- Go to Hosting > Error Logs.
- Select the domain you want to view logs for.
- Recent errors are displayed with timestamps, file paths, and error messages.
Access Logs
Access logs show all HTTP requests to your website, including the visitor's IP address, request path, status code, and user agent. Useful for monitoring traffic and identifying issues like 404 errors or suspicious activity.
Disk Usage
The Disk Usage page gives you a breakdown of storage consumption across directories, databases, and inodes. Use this to identify large files or folders that may be consuming your quota.
Billing & Plans
Manage your subscriptions and billing from your customer dashboard:
- View your current plans - See your email and hosting plan details, usage, and renewal dates.
- Upgrade or downgrade - Change your plan at any time. Upgrades take effect immediately.
- View invoices - Access your complete billing history and download invoices.
- Update payment method - Manage your payment details through our secure billing portal powered by Stripe.
- Cancel a subscription - You can cancel at any time. Your service will remain active until the end of your current billing period.
All payments are processed securely through Stripe. We accept all major credit and debit cards.
Two-Factor Authentication (2FA)
Two-factor authentication adds an extra layer of security to your account. When enabled, you'll need both your password and a second verification method to sign in.
Available Methods
- Email Code - A 6-digit code is sent to your email address each time you log in. Codes expire after 10 minutes.
- Authenticator App - Use an app like Google Authenticator, Authy, or Microsoft Authenticator to generate time-based codes. This is the recommended method as it works even without email access.
Setting Up 2FA
- Log in to your account and go to Account Settings.
- Click Manage 2FA to open the two-factor authentication settings.
- Choose your preferred method - Email Code or Authenticator App.
- For Email Code: confirm your password and 2FA will be enabled immediately.
- For Authenticator App: scan the QR code with your app, then enter the 6-digit verification code to confirm setup.
- After enabling either method, you will receive 10 backup codes. Save these in a safe place.
Backup Codes
Backup codes are single-use codes that let you sign in if you lose access to your primary 2FA method. Each code can only be used once.
- You receive 10 backup codes when you first enable 2FA.
- You can regenerate new codes at any time from your 2FA settings (this invalidates all previous codes).
- Store your codes securely and treat them like a password.
- If your remaining backup codes are running low, regenerate a fresh set.
Signing In with 2FA
After entering your password, you'll see a challenge screen asking for your verification code. Enter the code from your email or authenticator app. If you can't access your code, click "Use a backup code" and enter one of your saved backup codes.
Disabling 2FA
You can disable two-factor authentication from your account settings at any time. You'll need to confirm your password to make this change. If you're locked out of your account, contact support for assistance.
Troubleshooting & FAQ
I can't send or receive emails
- Check that your domain's DNS records are correctly configured in your dashboard.
- Verify your mail client settings match the configuration details above.
- Ensure your mailbox password is correct. You can reset it from the dashboard.
- If you recently added your domain, allow up to 24 hours for DNS propagation.
My emails are going to recipients' spam folders
- Ensure SPF, DKIM, and DMARC DNS records are all properly configured.
- Check your domain verification status in the dashboard. All records should show as verified.
- Avoid sending large volumes of email to recipients who haven't opted in.
My website is showing a 500 error
- Check your Error Logs in the hosting control panel for details.
- Make sure your .htaccess file does not contain syntax errors.
- Verify your PHP version is compatible with your application.
- Check that file permissions are correct (644 for files, 755 for directories).
My website is not loading after adding the domain
- Verify that your domain's A record points to the correct server IP (shown in your dashboard).
- DNS changes can take up to 24-48 hours to propagate. Try clearing your browser cache or using a different network.
- Make sure you have uploaded files to the correct document root folder.
How do I reset a mailbox password?
Go to Mailboxes in your dashboard, click on the mailbox, and use the password reset option.
Can I use my own domain?
Yes! Both our email and web hosting services are designed for you to bring your own domain. You can add any domain you own.
What happens if I exceed my storage quota?
For email, the mailbox will no longer accept new messages. For web hosting, you may not be able to upload new files. You can free up space or upgrade your plan for more storage.
Need more help?
Contact our support team by submitting a ticket from your customer dashboard or email us directly.
Can't find what you're looking for? Contact support
Back to top