Use this manual only if you have not previously installed our module in your WHMCS installation.
Please follow the instructions here if you want to upgrade from a previous version.

Server Module

Connect to your WHMCS server via (s)FTP or SSH and upload the Nextcloud folder to ROOT_DIRECTORY/modules/servers. Where ROOT_DIRECTORY is the main directory where WHMCS is installed.

Generate App Password in Nextcloud

This module requires an app password for authentication with the API. Take the following steps to generate the password.

1. Open your Nextcloud admin portal (e.g. cloud.domain.tld).
2. Open the settings page by clicking your profile picture (upper right corner) and clicking Settings.
3. Open the Security Tab in the left menu.
4. Now scroll to the bottom of the page and fill in an App Name under the Devices & sessions section. Click Create new app password.
5. Copy and paste this password to a secure location. You will need this password later in the installation process. Treat this password as a regular password! If third parties get this password, they can take control of your Nextcloud Server.

Add Email Template to WHMCS

1. Navigate to Setup -> Email Templates inside your WHMCS admin area.
2. Click the Create New Email Template button.
3. Select Product/Service as Email Type and enter a Unique name in the field. You can enter something like Nextcloud Welcome Mail.
4. Enter a Subject for the default version of this email.
5. Copy and paste the Email template included in the module to the content of the email template in WHMCS.
6. Click save changes or translate the mail to other languages.

Add Product to WHMCS

You do not have to add a Server (Setup -> Products/Services -> Servers) but instead you need to add a product directly.

1. Please go to Setup -> Products/Services -> Products/Services and make a new product group by pressing Create a New Group. You may also use an existing group but that is up to you.
2. After configuring your product group (Documentation) you can add your first Nextcloud service.
3. Press Create a New Product and select Other as Product Type.
4. Now select your group you just created and enter a Product Name.
5. After entering your product name select Nextcloud as Module and click Continue.
6. You will be redirected to the WHMCS product configuration page where you will need to enter more information about the product. Please make sure that the Welcome Email is set to the correct Welcome Email Template (included in the module).
7. Make sure that Require Domain is not checked.
8. Setup your pricing structure.
9. Click Module Settings and make sure Nextcloud is selected. Now enter the Admin Username and App Password we’ve previously generated.
10. Enter your cloud URL using the following format. Make sure you do not enter the protocol (this Module always uses HTTPS) and no trailing slash.
    1. If you use a subdomain: subdomain.domain.tld
    2. If you use a subdirectory: domain.tld/directory
    3. If you use a full domain: domain.tld
11. Now enter the Quota. With the applicable format (e.g. 10GB or 1TB).
12. If needed, enter a group or groups seperated with a comma. These groups need to be already setup by a Nextcloud system adminstrator.
13. We recommend setting the automatic provisioning to Automatically setup the product as soon as the first payment is received.
14. Make sure NO server group is selected.
15. Now Save the product and repeat these steps for the different services you are offering. You may also duplicate products.
16. You’re done! You can start offering Nextcloud services to your customers.

That’s it! You have successfully installed the Nextcloud Provisioning Module to your WHMCS installation. If you need help please don’t hesitate to contact us.