IMPORTANT
vCanopy requires a BRAND NEW KVM virtualised VPS or bare metal server with only a standard Ubuntu 18.04 LTS or 20.04 LTS image installed (NOT a Minimal version). Once initial provisioning is complete at the provider, log in to your server via console or SSH and run the following command as ROOT. Please do not use servers with less than 1GB of RAM as these cannot be supported and don't offer adequate resources for both the server stack and your websites. vCanopy does not support ARM servers.
In this article we are going to provision a Google Cloud Platform server and then install vCanopy from the command line. Although these instructions refer to Google and their specific platform, this same process will work for any VPS provider. If you run into trouble at any time, drop us a ticket in chat and we’ll be happy to help you through it.
If you already have a Google Cloud Platform account or are using a different provider, skip down to step 2.
Step 1. Sign Up for Google Cloud Platform
First navigate to cloud.google.com and click on Try GCP Free. By completing this process, you will receive $300 in credits to spend on Google Cloud Platform over the next 12 months.
Select your country and agree to the terms of service. Depending on the type of Google account and services you already have, the amount of terms you must agree to will vary. Once you continue, Google will require a credit card to make sure you are a human. You will not be charged unless you manually upgrade to a paid account.
On the next page, enter your account details and add a credit/debit card or bank account then proceed to start your trial.
Step 2. Login and Create Your Google Cloud Platform Server For vCanopy
In the left sidebar, click on Compute Engine and then VM instances.
Note: If this is your first time creating a server, you will need to click Enable Billing after which Google Cloud Platform will have to complete a short setup within your account. You will not be charged as you are still within your $300/12month trial period.
Click the Create (or the create instance blue plus (+) button if you already have an existing server) button to create the server.
Name your instance something accurate such as “vCanopy-rules” and select a zone (location). Choosing a location closest to most of your end users is generally best.
For Machine Type, use the drop down to select one of many preconfigured cpu and memory options. Should none of those suit your needs, you can create a custom configuration by clicking Customize.
For Boot Disk, select Ubuntu 18.04 LTS or 20.04 LTS. Do NOT use Ubuntu Minimal images.
For Boot Disk Type, select “SSD Persistent Disk” with at least 25GB (30+ as a minimum would be even better – please disregard the “20” in the screenshot below). Click the Select button when you’re done.
Now you’ll need to reserve a Static IP Address for your server. This is VERY IMPORTANT as vCanopy cannot manage your server without having a Static IP Address to reference.
Click and expand the Management, security, disks, networking, sole tenancy section.
custom-vps-08.png
- Click Networking.
- Under Network interfaces, click on the default network interface to edit it.
- Under the External IP section, select the drop-down menu and click on Create IP Address.
- In the resulting pop up window, name your Static IP Address and optionally give it a Description.
- Click Reserve to finish creating and assigning the address to this server.
The resulting screen should look similar to this:
Click Create and your server will begin building. Build times will vary, but for this test the server was built in under a minute.
Step 3. Allow vCanopy To Access Your Google Cloud Server
vCanopy requires an open port to communicate with your new server. Expand the main left menu and scroll down to VPC Network under the Networking heading. Then select Firewall Rules.
Click on CREATE FIREWALL RULE at the top and enter the following information:
- Name: vCanopy-port
- Description: Required by vCanopy
- Logs: off (unless later it is determined you need them)
- Network: default
- Priority: 1000
- Direction of traffic: Ingress
- Action on match: Allow
- Targets: All instances in the network
- Source Filter: IP Ranges
- Source IP ranges: 0.0.0.0/0
- Second source filter: None
- Protocols and ports: Specified protocols and ports: tcp:11371
Click Create when finished, the resulting Firewall Rule will look like this:
This Firewall rule will allow all incoming traffic any IP address to your server’s TCP port 11371. vCanopy’s security will lock down and protect this port from any traffic originating from any location other than vCanopy, directly on the instance via UFW.
Step 4. Connect Your Server to vCanopy
Back in your vCanopy dashboard, click on Custom VPS from the Home page. Enter the name, IP (the external Static IP Address we reserved), and the Datacenter name you wish to use.
CHOOSE YOUR DATABASE
If you’re on the developer plan you’ll have the option to choose between Percona and MariaDB for your database.
Percona is based off the new MySQL 8. It has removed query caching (which was deprecated in 5.7 but was still available), and it has more advanced aspects for things like storing and managing json as a storage format. It will likely use more RAM than MariaDB.
MariaDB is still based on MySQL 5.7, which could mean fewer issues importing old WordPress websites from low-quality hosting environments. It will likely use less RAM than Percona.
Both are excellent options.
PROVIDER BACKUPS
We highly recommend that you enable provider backups. It’s a small price to pay for the extra insurance they offer.
CREATE YOUR SERVER
Click the Create Server button when you are happy with your configuration choices.
Type the following command to allow for root level commands to be run:
sudo -s
Then enter the string copied from the popup modal to install vCanopy:
This will initiate Stage 1 of installation. It will only take a few moments and ends when this message displays.
Approximately 15 minutes later, your new server will be complete, available on the vCanopy dashboard, and ready to build WordPress sites.
