How to set up Cyberpanel on Webdock
Last updated: March 30th 2023
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 Ubuntu Focal (Ubuntu 20.04) instance.
- You have shell (SSH) access to your VPS.
Note: Cyberpanel appears to be broken at this time. Neither SSH nor the cyberpanel admin panel are accessible. We'll test this again over the coming days. Meanwhile if you installed and found that it actually works, please let us know.
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.
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.
Now, you can manage your server by visiting the URL's and logging in with the credentials you copied.
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.