Introduction
The LEMP software stack is a group of software that can be used to serve dynamic web pages and web applications. This is an acronym that describes a Linux operating system, with an Nginx web server. The backend data is stored in MySQL and the dynamic processing is handled by PHP.In this guide, we will demonstrate how to install a LEMP stack on an Ubuntu 14.04 server. The Ubuntu operating system takes care of the first requirement. We will describe how to get the rest of the components up and running.
Note: The LEMP Stack can be installed automatically on your Droplet by adding this script to its User Data when launching it. Check out this tutorial to learn more about Droplet User Data.
Prerequisites
Before you complete this tutorial, you should have a regular, non-root user account on your server withsudo privileges. You can learn how to set up this type of account by completing steps 1-4 in our Ubuntu 14.04 initial server setup.Once you have your account available, sign into your server with that username. You are now ready to begin the steps outlined in this guide.
Step One — Install the Nginx Web Server
In order to display web pages to our site visitors, we are going to employ Nginx, a modern, efficient web server.All of the software we will be getting for this procedure will come directly from Ubuntu's default package repositories. This means we can use the
apt package management suite to complete the installation.Since this is our first time using
apt for this session, we should start off by updating our local package index. We can then install the server:sudo apt-get update
sudo apt-get install nginx
You can test if the server is up and running by accessing your server's domain name or public IP address in your web browser.
If you do not have a domain name pointed at your server and you do not know your server's public IP address, you can find it by typing one of the following into your terminal:
ip addr show eth0 | grep inet | awk '{ print $2; }' | sed 's/\/.*$//'
111.111.111.111 fe80::601:17ff:fe61:9801Or you could try using:
curl http://icanhazip.com
111.111.111.111
Try one of the lines that you receive in your web browser. It should take you to Nginx's default landing page:http://server_domain_name_or_IP
If you see the above page, you have successfully installed Nginx.
Step Two — Install MySQL to Manage Site Data
Now that we have a web server, we need to install MySQL, a database management system, to store and manage the data for our site.You can install this easily by typing:
sudo apt-get install mysql-server
The MySQL database software is now installed, but its configuration is not exactly complete yet.
First, we need to tell MySQL to generate the directory structure it needs to store its databases and information. We can do this by typing:
sudo mysql_install_db
sudo mysql_secure_installation
Next, it will ask if you want to change that password. If you are happy with your MySQL root password, type "N" for no and hit "ENTER". Afterwards, you will be prompted to remove some test users and databases. You should just hit "ENTER" through these prompts to remove the unsafe default settings.
Once the script has been run, MySQL is ready to go.
Step Three — Install PHP for Processing
Now we have Nginx installed to serve our pages and MySQL installed to store and manage our data, but we still need something to connect these two pieces and to generate dynamic content. We can use PHP for this.Since Nginx does not contain native PHP processing like some other web servers, we will need to install
php5-fpm, which stands for "fastCGI process manager". We will tell Nginx to pass PHP requests to this software for processing.We can install this module and will also grab an additional helper package that will allow PHP to communicate with our database backend. The installation will pull in the necessary PHP core files. Do this by typing:
sudo apt-get install php5-fpm php5-mysql
Configure the PHP Processor
We now have our PHP components installed, but we need to make a slight configuration change to make our setup more secure.Open the main
php5-fpm configuration file with root privileges:sudo nano /etc/php5/fpm/php.ini
cgi.fix_pathinfo. This will be commented out with a semi-colon (;) and set to "1" by default.This is an extremely insecure setting because it tells PHP to attempt to execute the closest file it can find if a PHP file does not match exactly. This basically would allow users to craft PHP requests in a way that would allow them to execute scripts that they shouldn't be allowed to execute.
We will change both of these conditions by uncommenting the line and setting it to "0" like this:
cgi.fix_pathinfo=0
Now, we just need to restart our PHP processor by typing:
sudo service php5-fpm restart
Step Four — Configure Nginx to Use our PHP Processor
Now, we have all of the required components installed. The only configuration change we still need to do is tell Nginx to use our PHP processor for dynamic content.We do this on the server block level (server blocks are similar to Apache's virtual hosts). Open the default Nginx server block configuration file by typing:
sudo nano /etc/nginx/sites-available/default
server {
listen 80 default_server;
listen [::]:80 default_server ipv6only=on;
root /usr/share/nginx/html;
index index.html index.htm;
server_name localhost;
location / {
try_files $uri $uri/ =404;
}
}
We need to make some changes to this file for our site.- First, we need to add an
index.phpoption as the first value of ourindexdirective to allow PHP index files to be served when a directory is requested. - We also need to modify the
server_namedirective to point to our server's domain name or public IP address. - The actual configuration file includes some commented out lines that define error processing routines. We will uncomment those to include that functionality.
- For the actual PHP processing, we will need to uncomment a portion of another section. We will also need to add a
try_filesdirective to make sure Nginx doesn't pass bad requests to our PHP processor.
server {
listen 80 default_server;
listen [::]:80 default_server ipv6only=on;
root /usr/share/nginx/html;
index index.php index.html index.htm;
server_name server_domain_name_or_IP;
location / {
try_files $uri $uri/ =404;
}
error_page 404 /404.html;
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /usr/share/nginx/html;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/var/run/php5-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
When you've made the above changes, you can save and close the file.Restart Nginx to make the necessary changes:
sudo service nginx restart
Step Five — Create a PHP File to Test Configuration
Your LEMP stack should now be completely set up. We still should test to make sure that Nginx can correctly hand.php files off to our PHP processor.We can do this by creating a test PHP file in our document root. Open a new file called
info.php within your document root in your text editor:sudo nano /usr/share/nginx/html/info.php
Now, you can visit this page in your web browser by visiting your server's domain name or public IP address followed by
/info.php:http://server_domain_name_or_IP/info.php
You should see a web page that has been generated by PHP with information about your server:
If you see a page that looks like this, you've set up PHP processing with Nginx successfully.
After you test this, it's probably best to remove the file you created as it can actually give unauthorized users some hints about your configuration that may help them try to break in. You can always regenerate this file if you need it later.
For now, remove the file by typing:
sudo rm /usr/share/nginx/html/info.php
