Guides - Deploying Webuzo through the Linode Marketplace

Softaculous Webuzo is a single user LAMP stack control panel that allows you to deploy a growing number of applications and scripts on your server with a single click.

The Linode Marketplace allows you to easily deploy software on a Compute Instance using the Cloud Manager. See Get Started with Marketplace Apps for complete steps.

1. Log in to the Cloud Manager and select the Marketplace link from the left navigation menu. This displays the Linode Create page with the Marketplace tab pre-selected.

2. Under the Select App section, select the app you would like to deploy.

3. Complete the form by following the steps and advice within the Creating a Compute Instance guide. Depending on the Marketplace App you selected, there may be additional configuration options available. See the Configuration Options section below for compatible distributions, recommended plans, and any additional configuration options available for this Marketplace App.

4. Click the Create Linode button. Once the Compute Instance has been provisioned and has fully powered on, wait for the software installation to complete. If the instance is powered off or restarted before this time, the software installation will likely fail.

To verify that the app has been fully installed, see Get Started with Marketplace Apps > Verify Installation. Once installed, follow the instructions within the Getting Started After Deployment section to access the application and start using it.

Note

Estimated deployment time: Webuzo should be fully installed within 15-20 minutes after the Compute Instance has finished provisioning. During this time, the instance is rebooted once. This time frame depends on a variety of factors, including which data center has been selected.

• Supported distributions: Ubuntu 20.04 LTS
• Recommended minimum plan: All plan types and sizes can be used.

You can optionally fill out the following fields to automatically create a limited user for your new Compute Instance. This is recommended for most deployments as an additional security measure. This account will be assigned to the sudo group, which provides elevated permission when running commands with the sudo prefix.

• Limited sudo user: Enter your preferred username for the limited user.
• Password for the limited user: Enter a strong password for the new user.
• SSH public key for the limited user: If you wish to login as the limited user through public key authentication (without entering a password), enter your public key here. See Creating an SSH Key Pair and Configuring Public Key Authentication on a Server for instructions on generating a key pair.
• Disable root access over SSH: To block the root user from logging in over SSH, select Yes (recommended). You can still switch to the root user once logged in and you can also log in as root through Lish.

After the deployment process has finished and your Compute Instance has rebooted, log in to the Webuzo Admin panel and complete a few post-installation steps. This includes adding a user, setting the domain (or IP), and optionally including a license key.

1. Access the Webuzo Admin panel by opening a web browser and navigating to the following URL: http://[ip-address]:2004, replacing [ip-address] with the IPv4 address or rDNS domain assigned to your new Compute Instance. See the Managing IP Addresses guide for information on viewing IP addresses.

2. In the login screen that appears, enter your root user credentials and click Login.

   Note

   If you do not see the login screen, the deployment process may not yet be complete.

3. Once logged in, the Admin panel should appear.

4. Configure the Hostname and Nameservers. You can optionally set a custom hostname and custom nameservers. If you skip this step, you won’t be able to use the DNS functionality of Webuzo and will instead need to manually manage your DNS on external nameservers.

   To set your hostname and name servers, navigate to Settings > Panel Config and make any needed adjustments to the Hostname (Panel domain) and nameserver (NS1 and NS2) fields. If you registered the domain name example.com, you may want to configure your Hostname as server.example.com and your name servers as ns1.example.com and ns2.example.com. Before doing so, you need log in to your DNS provider and add an A record from server.example.com to the IPv4 address of your Compute Instance. You also need to register the name servers through your domain’s registrar. For further instructions, consult your domain registrar’s documentation.

5. Create a user. Webuzo allows you to have multiple users, each with their own website(s), resource allowances, and dedicated backend panels. To create your first user, navigate to Users > Add User. In the Add user page that appears, fill out the desired username, password, domain, and email address for the new user. You can also set custom resource allotments and additional settings as needed.

6. Log in as the user. You can log in to the user panel (also called the enduser panel) by navigating to the following URL: http://[ip-address]:2002. At the login prompt, enter the user credentials that you just created and press Login. The user panel should appear:

Once Webuzo is fully installed, you can start using it by accessing both the Admin dashboard and Enduser dashboard. Both require you to login using the username and password you just created on the setup screen.

• Admin Dashboard (http://[ip-address]:2004): Modify the core configuration and manage the apps that are able to be installed.

• Enduser Dashboard (http://[ip-address]:2002): Install individual applications and manage domains, emails, databases, and more.

Note

Currently, Linode does not manage software and systems updates for Marketplace Apps. It is up to the user to perform routine maintenance on software deployed in this fashion.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

• Webuzo Documentation
• Softaculous Support