Tutorial

How To Install WordPress on Ubuntu 12.04

Published on June 28, 2012
How To Install WordPress on Ubuntu 12.04
Not using Ubuntu 12.04?Choose a different version or distribution.
Ubuntu 12.04

Status: Deprecated

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.

What the Highlighting Means

The lines that the user needs to enter or customize will be highlighted in this tutorial! The rest should mostly be copy-and-pastable.

About WordPress

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.

Setup

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!

Step One—Download 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 

Step Two—Create the WordPress Database and User

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

Step Three—Setup the WordPress Configuration

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.

Step Four—Copy the Files

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

Step Five—RESULTS: Access the WordPress Installation

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).

See More

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

By Etel Sverdlov

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about our products

About the authors

Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
10 Comments


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:

  1. Go to /etc/apache2/mods-enabled/ directory. To do this, type “cd /etc/apache2/mods-enabled/” without the quotes.
  2. Open the dir.conf file so you can edit it. To do this, type “sudo nano dir.conf” without the quotes.
  3. You will see a line of index files (index.html, index.php, index.cgi, etc) under the DirectoryIndex setting. Add index.php as the first item in the list. Doing so will tell Apache to first look for and load an index.php file before looking for the other index file extensions.
  4. Press Ctrl+X to save your changes and then press Enter to exit the editor.
  5. Restart Apache by typing “sudo /etc/init.d/apache2 restart” without the quotes.

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

ben
DigitalOcean Employee
DigitalOcean Employee badge
November 16, 2012

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!

Etel Sverdlov
DigitalOcean Employee
DigitalOcean Employee badge
November 21, 2012

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.

Etel Sverdlov
DigitalOcean Employee
DigitalOcean Employee badge
December 26, 2012

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”

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Become a contributor for community

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

DigitalOcean Documentation

Full documentation for every DigitalOcean product.

Resources for startups and SMBs

The Wave has everything you need to know about building a business, from raising funding to marketing your product.

Get our newsletter

Stay up to date by signing up for DigitalOcean’s Infrastructure as a Newsletter.

New accounts only. By submitting your email you agree to our Privacy Policy

The developer cloud

Scale up as you grow — whether you're running one virtual machine or ten thousand.

Get started for free

Sign up and get $200 in credit for your first 60 days with DigitalOcean.*

*This promotional offer applies to new accounts only.