WPCloud Deploy Documentation

DigitalOcean Template Image


We have created an image on the DigitalOcean marketplace where you can quickly create a site with WPCloudDeploy already pre-installed.

Just choose the image and create your droplet.

The image can be viewed here: https://marketplace.digitalocean.com/apps/wpclouddeploy

You then need to SSH into the droplet to continue the setup process.

When you login for the first time you will be asked to choose your domain and to provide your email address.

If the domain you provide is pointed to the IP address of the new droplet we’ll request an SSL certificate.  We strongly recommend that you point your domain IP address to the new droplet so that the SSL certificate can be issued.

When you get to the end of the process you will see additional instructions on how to access the site.

Using WPCloudDeploy For The First Time

1. Connect To DigitalOcean

Before you can create servers and sites, you do need to perform some setup work in your DigitalOcean account to link it to the WPCloudDeploy app.

  1. Make sure you have at least one SSH key pair installed at Digital Ocean.  If you don’t have a key pair, use this guide to learn how to generate one.  And this one explains how to upload your public key to the Digital Ocean control panel.
    1. It is very important that you do this BEFORE you proceed to the next step.  The reason is that once you add your API key to our plugin, it will attempt to retrieve your SSH keys and it will cache them.  If you then proceed to change or add new keys, you’ll need to wait until the cache times out (around 15 minutes) before you’ll be able to see the new keys in WPCloudDeploy.
  2. Create an API key at Digital Ocean – you can do this inside your DigitalOcean dashboard.
  3. Go back to WPCloudDeploy and navigate to the WPCloudDeploy -> Settings -> Cloud Poviders tab.
  4. Fill out the API Key field then click the save button at the bottom of the screen.
  5. Now, the SSH key dropdown will be filled in with the keys you uploaded to DigitalOcean.  Select one of them.  If you do not see this dropdown, you can try one of the following:
    1. Click the SAVE button again – sometimes you just need to query the cloud provider a second time (some of them perform a sort of micro-caching)
    2. Use the CLEAR CACHE button at the bottom of settings screen for the provider
    3. Wait 15 minutes and try again – see the first step above to understand why this might work.
  6. Add the private key portion to the PRIVATE SSH KEY box.  It is very very important that you make sure the private key data matches the public key you selected in the prior step.  View important notes about private ssh keys.
  7. Add your private key password if any.
  8. Save the settings.

Now you’re ready to quickly run through the steps to get your first server and site up and running.

2. Create Your First Server

To create your first server:

  2. Click the DEPLOY A NEW WORDPRESS SERVER at the top of the screen.
  3. Follow the instructions on the screen and then go get a cup of coffee – it’ll take about 20 minutes for the server to be deployed.

3. Install Your First Site

To create your first site after creating your first server:

  2. Click the INSTALL WORDPRESS button in the Server Actions column. This should be at most a five minute process.
  3. Update your DNS for the new site/domain to point to the server.