Introduction

Cyberpanel is an open-source control panel. It makes site deployments easier and uses a lightweight web server called OpenLiteSpeed.

Prerequisites

• A fresh Webdock cloud server using Ubuntu Focal (Ubuntu 20.04) or any other OS supported by CyberPanel.

• You have shell (SSH) access to your VPS.

Create new shell user and SSH to your server

Create new shell user. After creating the shell user, on the right side, enable "Passwordless Sudo" and apply the settings.

Note: Cyberpanel works out-of-the-box on Ubuntu Focal. If you are installing Cyberpanel on any other OS, you need to do the fstab change as mentioned in this guide.

Installing Cyberpanel on your Webdock server

WebSSH into your Webdock server.

Become root user by executing:

$ sudo su -

Run the below command to start Cyberpanel installation.

# sh <(curl https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)

When asked for prompt, enter 1 to install Cyberpanel.

Then enter 1 or 2, as per your requirement.

Answer the on-screen questions based upon your requirement.

Once installation completes you will see several login credentials. Copy all of that to a safe place and then choose y to restart your server (only if you're on Ubuntu Focal). Now, you can manage your server by visiting the URL's and logging in with the credentials you copied.

Note: Do not restart your server if you've to modify the fstab file. So choose N when prompted and follow the steps below.

Modifying the Fstab File

Note: This step is only needed if you're installting on any OS other than Ubuntu Focal (Ubuntu 20.04).

Once the installation is finished and you hit N for the restart prompt, you'll need to comment all the lines added to the /etc/fstab file. 

Open the file using nano (or vi if you prefer it)

$ sudo nano /etc/fstab

Comment all the lines as shown in the screenshot below.

Once done, save the changes. Now you can restart the server and use Cyberpanel.

Upgrading Cyberpanel

Note: If this is the first time you are installing Cyberpanel you can simply skip this step.

You can upgrade Cyberpanel using the below command.

# sh <(curl https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)

Problems with dovecot

We have observed that CyberPanel is installing an older version of Dovecot on Ubuntu 20.04, preventing Dovecot from running. In order to fix this, you need to manually remove the existing installation of Dovecot and install the latest packages by following the instructions from Dovecot's official documentation.

Another issue: If dovecot doesn't start and you see an error similar to the following when running journalctl -xe

-- The unit tmp.mount has entered the 'failed' state with result 'exit-code'.
Oct 28 15:35:19 infographics systemd[1]: Failed to mount /tmp.
-- Subject: A start job for unit tmp.mount has failed
-- Defined-By: systemd
-- Support: http://www.ubuntu.com/support

Then simply mask the tmp.mount unit and enable/start dovecot:

systemctl mask tmp.mount
systemctl enable dovecot
systemctl start dovecot

We have no idea why Cyberpanel wants to mount /tmp as it's already mounted and writeable in our environment. It doesn't make sense why they would want to do this, but if you know the rationale behind this, please let us know as we are curious.

It does not seem this workaround has any ill effects from what we can see.

Email Setup

For emails, any Webdock server profile (except the Nano4) provides Postmark email feature as an addon. You can view that in the Webdock control panel by clicking the "three vertical dots" and go to Manage Email.

Connect your domain to Postmark and add the records to your DNS setup.

Wait for 15 minutes to receive verification email from Postmark.

You can then enter Postmark SMTP credentials in an SMTP client for emails to work (for example, you may host a WP site so you install SMTP plugin in WP and enter Postmark SMTP credentials in order to send emails).

Conclusion

Hopefully, the installation might have completed without any errors. For documentation you can have a look at the Cyberpanel Github repo.

If you have any issues with the setup feel free to comment below or contact Webdock support.