Digital Ocean v2

Digital Ocean v2: Migrate V1 to V2

Digital ocean module v2 is not a direct upgrade for v1. here are the steps required to migrate a client from v1 to v2.

Setup Products

  • Please ensure you have followed the setup guide and have a v2 product ready.


  • Please see the following video which shows how to copy droplet data to a new service


  • If a client has snapshots, you will need to order a snapshot product and manually enter the snapshot_id and name (similar to adding droplet_id in the above video). The snapshot_id and name can be found in your Digital Ocean client area.
Digital Ocean v2

Digital Ocean v2: Customization

There are several .tpl files in /modules/servers/ folders that can be edited as required
You can also edit the “Dedicated/VPS Server Welcome Email”. This must contain:

Main IP Address: {$service_dedicated_ip}
Username: {$service_username}
Password: {$service_password}
Digital Ocean v2

Digital Ocean v2: Email Piping or POP/IMAP import

For clients to be able to receive the droplet login details, you will need to setup email piping. We recommend creating a separate email address (such as [email protected]) to avoid any issues with non Digital Ocean emails.

The email address must be setup with Digital Ocean here.

The correct paths and method of installation will depend on your server – please check with your control panel provider or system administrator for exact setup instructions.

You only need to setup POP/IMAP or Piping, not both.



Setup the login details for your mail server:

Screen Shot 2015-02-11 at 18.52.50

Then create a php cron job to the import file, we recommend every 5 minutes e.g.

*/5 * * * * /path/to/php /path/to/modules/addons/digitalocean2/import.php

Next Step.. Customization

Digital Ocean v2

Digital Ocean v2: Installation

  • Upload the modules folder
  • cd to modules/servers/digitalocean2
  • ensure you have composer installed and run ‘composer install’
    • Note: after each module update, ensure you delete the vendors folder and re-run ‘composer install’
  • Visit Setup>Addon Modules
    • Click activate
    • Click configure
      • Enter your license & API token
      • Tick Full Administrator
      • Click Save
        View Screen Shot
  • Go to Addons > Digital Ocean v2 > Module Info
    • Edit the settings as required
    • {Note:} if you receive a cURL error, tick the disable_ssl option and save changes
      View Screen Shot
  • Go to Addons > Digital Ocean v2 > Products
    • Create the products as shown in the following video
    • {Note:} DO NOT change group names
    • {Note:} full list of images/regions can be found on the addon pages

Next Step.. Setup Email Piping or POP/IMAP import

Digital Ocean Digital Ocean v2

Digital Ocean: Changelog

– Modified: minor fixes and improvements
– Added: support for WHMCS 7.5 & PHP 7.1+
– Added: option for client to add ssh key when creating droplet
– Added: option to have a live list of images, or list specified from configurable options when rebuilding droplets
– Added: check for php-imap on addon page
– Added: better error reporting in client area
– Modified: major code changes
– Modified: minor changes to addon pages
– Modified: minor clientarea tweaks
– Modified: uses image slugs when creating confgurable options
– Removed: email piping, must now use IMAP import
– Fixed: fixed IMAP issue
– Added: debug information for support requests
– Fixed: added workaround for custom field bug
– Modified: updated updated database calls to use capsule
– Modified: other minor changes
– Modified: updated client area for WHMCS 6
– Modified: will now power off droplet during resize
– Added: additional information in client area (e.g. memory, cpus, disk space etc.)
– Added: additional information in admin area (e.g. memory, cpus, disk space etc.)
– Added: ability for client to change kernel
– Added: user data can be added by clients on order form
– Fixed: client area for custom themes
– Added: Resize disk when upgrading
– Modified: Option to disable IMAP certificate validation
– Fixed: Fixed error caused by complex IMAP passwords
– Fixed: Minor bug fixes
– Fixed: Minor bug fixes
– Added: Ability to create products with required settings from within module
– Added: If no hostname set srv{serviceid} will be set
– Added: IPv6 saved to ‘assigned IPs’ in WHMCS
– Added: All IPs saved under ‘notes’ in WHMCS to comply with proposed government regulations
– Added: debug log
– Added: send email on creation fail
– Added: push snapshot to all regions
– Added: DNS/Domain support
– Added: POP/IMAP import of emails
– Modified: Updated to APIv2
– Modified: Snapshots now a separate product (can be billed separately from droplet)
– Modified: IPv6 and Private Networking enabled by default (where available)
– Modified: Revamped ClientArea
– Modified: Processing bar when performing actions
– Fixed: Email piping
– Module now only supports configurable options
– Modified admin area to display droplet IDs
– Modified create command so if hostname/domain is empty auto generate one
– Modified create option groups command to include all available regions/images
– Modified terminate command to always scrub data
– Modified email pipe to use whmcs “Dedicated/VPS Server Welcome Email” template
– Modified management actions to hide actions
– Added save username and default password to database
– Added clientarea.tpl for the client area
– Added destroy option on control tab
– Added support for Private Networking
– Added support for global SSH Keys
– Minor changes to cURL connection
– Fixed backup issue after Digital Ocean system changes
– Added language file for email
– Added suspend/unsuspend function
– Added language file for client area
– API cURL fixes
– Added auto create option group button
– Added option to use configurable option groups for Datacenter and Operating System
– Added ability for client to rename/change hostname of droplet
– Added dropdown for choosing droplet size
– Added option to reinstall snapshot from another droplet in the same datacentre
– Added completed history items status to database for faster loading
– Added support for backups
– Added support for snapshots
– Piping timeout bug fixes
– Ability to get IP address if it is not assigned
– Option to fix cURL SSL error
– Better error messages
– Display API error details
– New admin addon page layout
– Added droplet list to addon page
– View current module version & latest version
– Upgrade/Downgrade droplets (see notes)
– First Release
– Development Version
– Development Version