Knowledgebase

Overview

WebDeck is a modern Linux hosting control panel that installs and manages your entire hosting stack, including the web server, PHP, databases, DNS, mail services, SSL certificates, backups, and customer management—all from a single interface.

Unlike traditional server management, WebDeck is designed to automate the entire setup process, allowing you to deploy a fully functional hosting environment within minutes.

Requirements

Before installing WebDeck, ensure your server meets the following requirements.

Supported Operating Systems

• Debian 11, 12, and 13

• Ubuntu 20.04, 22.04, and 24.04

• Rocky Linux 8, 9, and 10

• AlmaLinux 8, 9, and 10

• RHEL 8 and 9

Minimum Requirements

• 1 vCPU

• 1 GB RAM

• 10 GB Disk Space

• Fresh installation of a supported operating system

• Root SSH access

• Public IPv4 address

Recommended for Production

• 2 or more vCPUs

• 4 GB RAM or higher

• 40 GB SSD or larger

• Proper reverse DNS (PTR/rDNS)

• Outbound port 25 open if hosting email directly

Important

WebDeck should only be installed on a fresh server. Installing it on a server that already has Apache, Nginx, MariaDB, PowerDNS, Postfix, Dovecot, or another hosting control panel may cause conflicts because WebDeck manages the complete hosting stack.

Installation

Step 1 – Connect to Your Server

Log in to your server as the root user using SSH.

ssh root@YOUR_SERVER_IP

Step 2 – Download and Run the Installer

Run the official WebDeck installer:

wget https://www.webdeckpanel.co.uk/downloads/webdeck-installer.tar.gz
tar xzf webdeck-installer.tar.gz
cd webdeck-installer-pkg
bash install.sh

The installer will automatically:

• Detect your Linux distribution

• Install all required packages

• Configure the hosting stack

• Install WebDeck

• Start all required services

Depending on your server and internet connection, the installation usually completes within a few minutes.

Accessing the Control Panel

After installation finishes, WebDeck displays a unique hostname similar to:

https://srv-a1b2c3.wd-server.co.uk:2087

This hostname includes a browser-trusted SSL certificate, allowing secure access without certificate warnings.

Alternatively, you may access the panel directly using your server IP:

https://YOUR_SERVER_IP:2087

When connecting via the IP address, your browser will display a security warning because the server uses a self-signed SSL certificate until you use the provided hostname or configure your own certificate.

Save Your MySQL Root Password

During installation, WebDeck generates a MySQL root password.

The installer displays this password and also stores it in:

/opt/vm6panel/.env

Store this password securely, as it may be required for future database administration or recovery tasks.

First-Time Setup Wizard

The first time you log in, WebDeck launches a setup wizard to configure the server.

The wizard includes:

• Activating your licence or starting a 14-day trial

• Creating the administrator account

• Configuring your nameservers

• Selecting your preferred web server (Apache, Nginx, or OpenLiteSpeed)

• Configuring the mail server (optional)

• Completing the initial server configuration

Once finished, you'll be redirected to the WebDeck dashboard.

Administrator Login

Administrators and resellers access the control panel using port 2087:

https://YOUR_SERVER_IP:2087

Customers also use the same login URL but are presented only with resources assigned to their account. Webmail is accessible directly from within the control panel.

Recommended Post-Installation Tasks

After installation, we recommend that you:

• Enable Two-Factor Authentication (TOTP)

• Configure your nameservers

• Add your first website

• Verify DNS resolution

• Configure scheduled backups

• Review firewall settings

• Update WebDeck whenever new releases become available

Troubleshooting

Browser Displays a Certificate Warning

If you access the panel using:

https://YOUR_SERVER_IP:2087

a self-signed SSL certificate is used, so your browser will display a warning.

For a trusted SSL certificate, access the panel using the hostname generated by the installer.

Unable to Access Port 2087

Verify that:

• WebDeck services are running

• Port 2087 is open in your server firewall

• Your VPS provider is not blocking the port

• The server is reachable over the Internet

Need Help?

If you experience installation issues, check the installation log located at:

/var/log/webdeck-install.log

You can also inspect the WebDeck service status using:

systemctl status vm6panel

and review recent logs with:

journalctl -u vm6panel -n 50

These logs provide valuable information for diagnosing installation or startup issues.