Troubleshooting: Custom Server Won’t Provision and is Stuck at 10%.
In this article we’re going to provision a Hetzner Cloud Server (VPS) and then install GridPane from the command line. If you already have an account and servers at Hetzner you can skip to step 3.
Table of Contents.
Hetzner is a very interesting EU based hosting company that owns and operates several of its own datacentres in Germany, Finland and they now also offer servers the US. Their prices are very competitive and from what I’ve seen also have a very good reputation, and they’ve been around for a long time – founded in 1997.
Hetzner offers both dedicated servers and VPS servers (which they call “Cloud” servers), and they have VPS options that come with dedicated vCPUs and flexible storage.
Step 1. Create a Hetzner Account
Head over to https://www.hetzner.com and create an account if you haven’t already. I’m not 100% clear on whether approval is required to get started as I was almost immediately approved to start creating servers, but just know that there may be an approval process (and if there is, please do let us know and I will update this article accordingly).
Add your details and payment info and then we’re good to begin.
Step 2. Create a Project
Before you can create a server you first need to create a project.
From the dropdown in the top right, select “Cloud”:
You’ll be taken to their pretty cool dashboard, and here you can create a new a project:
Click the big red button and a modal will open to give your project a name – I’ve named mine GridPane, but feel free to choose whatever name makes sense for you:
And your project has been created:
Step 3. Create a Server
Now that we’ve created a project we can create our server. Click on your project and you’ll be taken to the following screen:
Click the red Add Server button to get started.
Choose your preferred server location. Hetzner have server 2 locations in Germany and 1 location Finland.
Here it’s important to choose Ubuntu 20.04. GridPane will not work with any other platform/linux distribution.
Choose your server type (VPS or dedicated) and plan.
4 and 5. Volume / Network
You can leave these two options empty.
We strongly recommend server backups. They’re excellent insurance, and they it’s entirely possible they may save you one day.
Backups cost an additional 20% of your server price (at the time of writing, but likely always), and do not include “Volumes”.
7. SSH Key
Add an SSH key if you wish to do so. This is the most secure way to connect to your server.
As many new users don’t yet have an SSH key, I’ll provision this server with a password for demonstration purposes, and GridPane will lock down and prevent password logins in the future. In step 5 I’ll explain how to connect both via SSH and via password.
Finally, give your server a name that makes sense for you and you’re good to go.
Finally check all your settings, check the price, and then when you’ve confirmed all is correct hit the Create & Buy Now button.
You’ll then see your new server in your servers page:
Step 4. Connect Your Server to GridPane
Back in your GridPane dashboard, click on Custom VPS from the servers page.
Configure Your Server
Enter the name, IP, 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 examples server is in Falkenstein, we’ll go ahead and enter this.
Add Your Server IP
Add your server’s public IP address.
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 5. Connect to Your Hetzner Server
If you added your SSH key, then you can connect to your server using your preferred terminal (Putty, Terminus, Powershell etc).
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 then Hetzner will have emailed you the root password. You’ll need this now to login.
Connect Via Hetzner’s Console
Hetzner has an integrated console that you can use to connect to your server for the first time. You can find this on your servers page by clicking on the three dots on the right hand side of your server’s bar, and choosing console from the dropdown. This will immediately open the console in a new window:
Here first type:
And then enter the password that Hetzner emailed to you by right clicking inside the terminal and selecting Paste.
You’ll be forced to reset your password: –
- First re-paste the password Hetzner sent to you
- Enter your new password
- Re-enter your new password
You’re now good to go!
Step 6. Provision Your Server
Hetzner state that they now only ship with minimal images. We need to update it to full to ensure your server has everything we need, so before running our provisioning code.
1. Update Ubuntu from Minimal to Full
Run the following:
sudo apt-get update -y
Then run this to install full Ubuntu:
sudo apt install -y ubuntu-server
2. Enter Your Provisioning Code
We’re now logged in as
root and it’s time to paste in your provisioning code that you copied in step 4.
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, and you can then close the terminal by typing:
Step 7. 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.
Common Reasons for Hetzner Servers Failing to Provision Correctly
Hetzner is a provider that our team here at GridPane thinks highly of. That said, there are some common issues we routinely see in support related to provisioning their servers.
1. Arm64-architecture Servers
These can be pre-selected by default, but these servers will not work with GridPane. Please ensure you are NOT trying to provision an Arm54 server.
2. Minimal Ubuntu Images
We require a full Ubuntu OS. Please ensure that you have correctly followed the steps in this article.
3. Hetzer Alters Our Provisioning Code
This is also detailed above, but when pasting our provisioning code into Hetzer’s console, the “https://” part may be altered, which will need to be manually corrected.
4. Hetzners IP ranges have been banned by Google Cloud
If your IP ranges have been banned by GCP, your server will not be able to connect to our platform, and it will fail at 10%. There is nothing that we ourselves can do about this, and it is an issue you will need to contact Hetzner support for further information and assistance.