Monday, October 12, 2020

Download and Install WordPress Via the Shell Over SSH and With WP-CLI

Download and Install WordPress Via the Shell Over SSH and With WP-CLI

Installing WordPress often takes a lot of steps: downloading and uncompressing a zip file, uploading files to the server, and setting up the database and config. That can take a lot of time. Or you can do it by using the Fantastico or SimpleInstall utilities available via your host's control panel. There is nothing wrong with that, but it's not foolproof to say the least. In this post I'll show you a faster and more reliable way—with the shell over SSH.

Nowdays most hosting plans offer an SSH command-line facility so you should definitely consider the SSH method to download and install WordPress on your server. The big advantage  is that you don't need to visit different sites, and don't need to do any uploading or open any control panels. You do everything via a single command-line interface. For this you will need an SSH client. If you are running on Windows go for PuTTY and if you are on Mac you can use Mac's built-in Terminal or iTerm 2. Before we move ahead please make sure your host offers the Bash shell because our commands are configured for that.

At the end of this article, we'll also go through the WP-CLI tool which is an even easier way to download and install WordPress via command line.

1. Connecting to Your Server

Using PuTTY

Open PuTTY and enter your domain name in the box named Host name(or IP address) and enter the port number used to connect to SSH under Port, then click Open. You can even save your site settings by entering a name in the Saved Sessions box and by pressing Save. Next time you can always load the session by selecting your site and clicking Load.

PuTTY will now ask for your username. Enter your username and press Enter. Now you will be asked for your password. Note here that while you are typing your password, you won't see it being typed on the screen. It's hidden for security reasons. Press Enter after you've typed your password and you will be logged on.

Using any other SSH client or Mac Terminal

Enter the following command in your Terminal client to connect to your site's command-line over SSH:

The -p switch tells it to use the port number 22. If your host allows SSH over default port 22, you can omit -p and 22 in the above command, otherwise substitute 22 for your host's SSH port number. After logging in you will see something like this:

That is the shell command prompt where you will be typing all your commands from now on.

2. Downloading WordPress

Now that we have logged in to our SSH server, we need to go to the correct directory where we want to setup our blog. Then we download the files and extract them there. Supposing the directory you want your blog to be installed under is blogdemo residing under the public_html directory, you will use the following command:

Now that we have reached the correct directory we will download WordPress using the wget command.

The above command downloads the latest WordPress install from their server and extracts the file from it into the blogdemo directory. xf, and z are parameters which tell the tar command to extract the contents from the specified file using gzip.

Now after extraction you will find a wordpress directory under the blogdemo directory containing your install. So to shift the files back to where they should be use the following commands:

This command moves the contents of the wordpress directory into the current directory. Anytime you want to check what is in the current directory, type ls.

You can delete both the wordpress directory and the archive file you downloaded if you want using the following commands:

3. Installing WordPress

In this step we will create the database and corresponding user and associate them together. Then we will use the famous 5 minute install of WordPress to finish it off.

Note: Before moving ahead you will need to check whether you have got the privileges to create a database or not. An easy way to check is to go to your phpMyAdmin and check whether you can create a database from there or not. If you can't that means you won't be able to follow this step. You should check with your web host if they allow you to do so or not. Most shared web hosts will let you create a database.

First you need to login to the MySQL command-line using the following command:

After entering this you will be asked for your MySQL password. Type your password and you will be shown a screen like this:

MySQL Login

Now that we have logged in to the MySQL Server, we will first create a database and will grant access to the user to that database. Use the following commands now:

Don't forget the semi-colon at the end of each MySQL command. The first command creates the database. The second command allows the user to connect to the database. The final command grants all privileges to the user for that database. You can test whether your database creation was successful by running this command:

It should say database changed. Now you can exit the MySQL command-line by typing exit.

Now fire up the blog in your browser and run the usual WordPress install and use the database information we used in the third step to setup your wp-config.php and then setup your blog.

Note: New Database User

In our tutorial we are using an already existing database user to connect to the new database. But in case you want separate user for each database you need to create a new user to access that database. Here is how you should do it.

Once you are inside the MySQL shell, use the following commands to create a new user and set its password.

Now go back to Step 3 and run all other commands with this username.

Editing wp-config.php

In our tutorial I have told you that after doing everything on the shell you can directly proceed to the install. But some of you might want to edit wp-config.php to add special settings and code. You can only do that via the shell. While you are in your blog directory at the shell use the following command to fire up the Vim Editor (a command-line shell file editor)

Now you will see something like what's shown below:

Vim Editor

Press the i key to enter insert mode and use arrow keys to move around the file. Once you have made your edits, press the Esc key to exit insert mode. To exit Vim type : and then type wq and press Enter. This will save your changes and quit Vim.

Download and Install WordPress With the WP-CLI Tool

In this section, I'll show you an even better way to download and install WordPress: with the WP-CLI tool. First, we have to install the WP-CLI tool on the sever.

How to Install the WP-CLI Tool

Run the following commands on your server to download, install and configure the WP-CLI tool.

Let's check if the WP-CLI tool is installed successfully by using the following command.

You should see something like this:

Download and Install WordPress

Let's download the latest version of WordPress first place.

IF the download is successful, you'll see something like the following:

So we've downloaded the WordPress code base now.

Next, it's time to create the wp-config.php file. We can do it with the help of the following command. Replace the placeholders with the actual values. I assume that you've already created the database which you would like to use with WordPress.

Finally, let's run the following command which installs WordPress.

And with that, WordPress is installed successfully on your server! 

In fact, the WP-CLI tool is capable of doing a lot more than just installation. It allows you to manage plugins, themes and do necessary version updates as well. All in all, it's a great tool for WordPress developers, and I would encourage you to explore it! You can learn about WP-CLI here at Envato Tuts+.

Learn to Code PHP for WordPress With a Free Online Course

If you want to learn to code PHP WordPress, check out our free online course on learning to code PHP for WordPress!


 

In this course, you'll learn the fundamentals of PHP programming. To get started, you'll learn why WordPress uses PHP, how to create a PHP file, and how to mix HTML and PHP.  You'll go on to learn how PHP works and how to write simple PHP loops and functions. To wrap things up, you'll build a custom archive page to practice what you learned.

If you want to learn WordPress plugin development, we have a free course for that as well!


No comments:

Post a Comment