Troubleshooting: Custom Server Won’t Provision and is Stuck at 10%.
We have servers from providers all over the world connected to the GridPane platform. Generally, as long as you have everything setup correctly in step 1 (below), and your provider is not doing anything “non-standard”, almost all good quality server providers will work with GridPane.
If you’re running you’re own hardware, you should also check out this article:
Running GridPane on a Local Virtual Machine (VM) Demo
Table of Contents
Step 1. Create Your Server at Your Provider
It’s important to make sure your server meets the following 4 requirements.
1. Ubuntu Version
Make sure you’re using Ubuntu 20.04 LTS. If you’re provider only offers Ubuntu minimal versions, that’s OK. You can upgrade it to full before running our provisioning code.
Make sure ports 22, 80, and 443 are open. They usually are by default on almost all providers.
3. Firewall Whitelisting
If your provider has an active firewall, you may need to add the following three IP addresses to your whitelist:
126.96.36.199. Learn more here:
Whitelisting GridPane at Your Server Providers
4. ARM is not Support
ARM servers are not supported by GridPane, and these typically require application versions to be compiled for it in most cases. Most providers don’t offer this as an option.
Step 2. Connect Your Server to GridPane
Back in your GridPane dashboard, navigate to your Servers page and click on Custom VPS:
Configure Your Server
Enter the name, server IP address, and the Datacenter name you wish to use.
Note: The Datacenter name is for your reference only, so feel free to give it a name that makes the most sense for you. As this example’s server is in Falkenstein, we’ll go ahead and enter this.
We recommend that you choose Ubuntu 20.04 LTS as the default OS.
Choose Your Web Server
You have the option to choose between Nginx and OpenLiteSpeed. This is largely personal preference. If you’re unsure which one to choose, start with Nginx.
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.
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.
Step 3. Connect to Your New Server
The first time you connect to any new server you’ll be prompted with a security alert about the servers fingerprint. Click Yes to continue.
If you didn’t add an SSH key during the setup process, you’re provider will likely have emailed you the root password. They may also allow you to connect to your server directly through their own console.
Step 4. Run the Provisioning Code
Now connected to your server, you can complete the final steps.
If you’re provider only ships minimal images you will need to update it to full to ensure your server has everything we need BEFORE running our provisioning code.
1. Update Ubuntu from Minimal to Full (if applicable)
Run the following:
sudo apt-get update -y
Then run this to install full Ubuntu:
sudo apt install -y ubuntu-server
2. Ensure you’re running as the root user
If you’re not running as root, paste the following and hit enter:
3. Enter Your Provisioning Code
We’re now logged in and/or running as
root and it’s time to paste in the provisioning code that you copied in step 2.
Right click > Paste and then press Enter. The code the will do the rest. A few minutes later you’ll see the following message in the image below (example taken from our Hetzner article), and you can then close the terminal by typing:
Step 5. Wait for Approx 10 Minutes
You can monitor the rest of your servers provisioning progress inside the Servers page of your account. Approximately 10 minutes later it will be ready to use inside your GridPane account.
Congratulations! Next Steps
Now that your server is live, you’re ready to start creating and configuring new WordPress websites.
To deploy a site click on the Sites link in the GridPane main menu to begin the process. We have a separate article that details the steps in detail for you.