This article covers a version of Ubuntu that is no longer supported. If you are currently operate a server running Ubuntu 12.04, we highly recommend upgrading or migrating to a supported version of Ubuntu:
Reason: Ubuntu 12.04 reached end of life (EOL) on April 28, 2017 and no longer receives security patches or updates. This guide is no longer maintained.
See Instead:
This guide might still be useful as a reference, but may not work on other Ubuntu releases. If available, we strongly recommend using a guide written for the version of Ubuntu you are using. You can use the search functionality at the top of the page to find a more recent version.
The lines that the user needs to enter or customize will be highlighted in this tutorial! The rest should mostly be copy-and-pastable.
WordPress is a free and open source website and blogging tool that uses php and MySQL. It was created in 2003 and has since then expanded to manage 22% of all the new websites created and has over 20,000 plugins to customize its functionality.
The steps in this tutorial require the user to have root privileges. You can see how to set that up in the Initial Server Setup.
Before working with wordpress, you need to have LAMP installed on your virtual private server. If you don't have the Linux, Apache, MySQL, PHP stack on your VPS, you can find the tutorial for setting it up in the Ubuntu LAMP tutorial.
Once you have the user and required software, you can start installing WordPress!
We can download WordPress straight from their website:
wget http://wordpress.org/latest.tar.gz
This command will download the zipped WordPress package straight to your user's home directory. You can unzip it the the next line:
tar -xzvf latest.tar.gz
After we unzip the WordPress files, they will be in a directory called WordPress in the home directory.
Now we need to switch gears for a moment and create a new MySQL directory for WordPress.
Go ahead and log into the MySQL Shell:
mysql -u root -p
Login using your MySQL root password, and then we need to create a WordPress database, a user in that database, and give that user a new password. Keep in mind that all MySQL commands must end with semi-colon.
First, let's make the database (I'm calling mine `wordpress` for simplicity's sake; feel free to give it whatever name you choose):
CREATE DATABASE wordpress;
Query OK, 1 row affected (0.00 sec)
Then we need to create the new user. You can replace the database, name, and password, with whatever you prefer:
CREATE USER wordpressuser@localhost;
Query OK, 0 rows affected (0.00 sec)
Set the password for your new user:
SET PASSWORD FOR wordpressuser@localhost= PASSWORD("password"); Query OK, 0 rows affected (0.00 sec)
Finish up by granting all privileges to the new user. Without this command, the WordPress installer will not be able to start up:
GRANT ALL PRIVILEGES ON wordpress.* TO wordpressuser@localhost IDENTIFIED BY 'password'; Query OK, 0 rows affected (0.00 sec)
Then refresh MySQL:
FLUSH PRIVILEGES; Query OK, 0 rows affected (0.00 sec)
Exit out of the MySQL shell:
exit
The first step to is to copy the sample WordPress configuration file, located in the WordPress directory, into a new file which we will edit, creating a new usable WordPress config:
cp ~/wordpress/wp-config-sample.php ~/wordpress/wp-config.php
Then open the wordpress config:
sudo nano ~/wordpress/wp-config.php
Find the section that contains the field below and substitute in the correct name for your database, username, and password:
// ** MySQL settings - You can get this info from your web host ** // /** The name of the database for WordPress */ define('DB_NAME', 'wordpress'); /** MySQL database username */ define('DB_USER', 'wordpressuser'); /** MySQL database password */ define('DB_PASSWORD', 'password');
Save and Exit.
We are almost done uploading WordPress to the virtual private server. The final move that remains is to transfer the unzipped WordPress files to the website's root directory.
sudo rsync -avP ~/wordpress/ /var/www/
Finally we need to set the permissions on the installation. First, switch in to the web directory:
cd /var/www/
Give ownership of the directory to the apache user.
sudo chown username:www-data /var/www -R
sudo chmod g+w /var/www -R
From here, WordPress has its own easy to follow installation form online.
However, the form does require a specific php module to run. If it is not yet installed on your server, download php-gd:
sudo apt-get install php5-gd
Once that is all done, the WordPress online installation page is up and waiting for you:
Access the page by adding /wp-admin/install.php to your site's domain or IP address (eg. example.com/wp-admin/install.php) and fill out the short online form (it should look like this).
Once WordPress is installed, you have a strong base for building your site.
If you want to encrypt the information on your site, you can Install an SSL Certificate
Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.
This textbox defaults to using Markdown to format your answer.
You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!
Excellent tutorial. You may need to change the DirectoryIndex when installing Wordpress on a fresh LAMP box so that the index.php file will load. If you point your web browser to your server IP / domain and you only see the “It works” Apache page after installing/configuring Wordpress then you will need to edit the DirectoryIndex so Apache will load index.php as the default webpage. To do this, follow these steps:
I followed the above tutorial and found that mysite.com was still showing “It works” after installing Wordpress. I could still access the admin control panel but I was unable to view the blog. Adding index.php as the first file to load in the dir.conf file fixed this issue for me. Hope this helps others as well!
I’ve Just run through this and now getting the error when trying to start up mysql and DB connection error when tryign to access the website. ERROR 2002 (HY000): Can’t connect to local MySQL server through socket ‘/var/run/mysqld/mysqld.sock’ (111) Any ideas what could be causing this
Not sure what to do… :-S
It sounds like MySQL server isn’t running, hence a connection can not be made.
Make sure to install a valid LAMP environment first as detailed in: https://www.digitalocean.com/community/articles/how-to-install-linux-apache-mysql-php-lamp-stack-on-ubuntu
(L)inux (A)pache (M)ySQL (P)HP
If MySQL is properly installed you can start it with: sudo service mysql start
If it fails you can review the error log for more details /var/log/mysql.err or /var/log/mysql/error.log
Really a fantastic tutorial. I did have to modify dir.conf as suggested above by James Tansley (thanks for that James BTW!!) Can’t recommend this enough. Thanks for the hard word!
Thank you, and thank you, James! Please let me know if there are any further topics you would like to see covered in our community.
Thank You, James Tansley :)))
I tried to install new plugins but it needs ftp connection, of which is possible only through SSH, correct me if Im wrong. However I tried using Filezilla and managed to transfer the plugins folder to /wp-content/plugins. When I checked them on wordpress, the plugins are not there. Any idea whats the problem.
You may be able to install the plugins by temporarily changing the permissions of your web directory to 777 until the plugin is installed. As soon as the plug in has finished installing, the permissions should then be scaled back down to 755.
What is the ‘username’ referred in “sudo usermod -a -G www-data username” line? I’m trying to set up Wordpress on a virtual host so my WP home directory is “/var/www/example.com/public_html”. I’m guessing it might be the “demo” user equivalent or maybe something like “www-data” ? I’m lost, I don’t want to screw up. :)
I keep getting the “usermod : user ‘demo’ does not exist”