Difference between revisions of "RPi Apache2"

From eLinux.org
Jump to: navigation, search
(Installing Apache 2.x Web Server on Raspberry Pi)
(Testing Installation)
Line 30: Line 30:
  
 
== Testing Installation ==
 
== Testing Installation ==
 +
 +
You should now have an operational Apache2 web server!  There are a few ways to test this:
 +
* From the web server
 +
** command line<br />
 +
# Use a basic Internet tool to download the web server's starting page
 +
wget http://localhost/ ~/
 +
# Use your eyeballs to compare the source file with the downloaded file
 +
cat /var/www/index.html
 +
cat ~/index.html
 +
:* GUI (untested)
 +
::* Open the web browser (probably Midori)
 +
::* Browse to the following URL:
 +
http://localhost/
 +
::* You should see the following text (except with a bit more formatting):
 +
It works!
 +
This is the default web page for this server.
 +
The web server software is running but no content has been added, yet.
 +
* From another computer, using a web browser
 +
** Get the web server's IP address
 +
ifconfig eth0
 +
# Sample output from the previous "ifconfig eth0" command
 +
eth0      Link encap:Ethernet  HWaddr b8:27:eb:9b:03:55
 +
          inet addr:192.168.2.123  Bcast:192.168.2.255  Mask:255.255.255.0
 +
          UP BROADCAST RUNNING MULTICAST  MTU:1488  Metric:1
 +
          RX packets:17360 errors:0 dropped:0 overruns:0 frame:0
 +
          TX packets:4789 errors:0 dropped:0 overruns:0 carrier:0
 +
          collisions:0 txqueuelen:1000
 +
          RX bytes:11645538 (11.1 MiB)  TX bytes:443716 (433.3 KiB)
 +
 +
:: The IP address of the default network card is listed after the "inet addr:" title.  (In my example above, the IP address of my web server is "192.168.2.123".  Write down the IP address of your web server - you're going to use it during the next step
 +
:* Browse the web server from another computer using a GUI
 +
::* Open the web browser
 +
::* Browse to the following URL:
 +
<pre>http://<ip_address_of_web_server>/</pre>
 +
::* You should see the following text (except with a bit more formatting):
 +
It works!
 +
This is the default web page for this server.
 +
The web server software is running but no content has been added, yet.

Revision as of 01:11, 17 May 2012

Installing Apache 2.x Web Server on Raspberry Pi

This is a guide to install the Apache HTTP Server "Apache" on the Raspberry Pi computer running Debian "squeeze". The core of this guide is a basic installation of Apache, configured to serve static HTML pages. The serving of dynamic HTML pages via additional software like PHP and Ruby on Rails is beyond the scope of this guide, although these instructions could be used as a foundation before installing those additional components.

The guide has been developed/tested using debian6-19-04-2012. A standard 2Gb image has enough room for this install, although you may want to use a larger image to give yourself a bit more elbow room on the already-cramped root folder. (Learn how to expand your image here or here.) This guide requires a network connection.

The installation was all done from the basic (pre startx) command prompt.

A little Debian/Apache foreknowledge: The default Debian install of Apache will be configured to run in the "www-data" user space, and use the "www-data" group. The version of Debian used for this guide (debian6-19-04-2012) already includes the "www-data" user, but not the "www-data" group. The following commands will create the "www-data" group, and add the "www-data" user to the newly-created group:

# Create the www-data group
sudo addgroup www-data
sudo adduser www-data www-data

A touch more Debian/Apache foreknowledge: The default Debian install of Apache will be configured to serve HTML pages from the "/var/www" folder. While this folder is created during the Apache2 install process, it will likely be created with the wrong owner:group (root:root). We can ensure a smoother install and successful running of Apache2 by creating this folder ahead of time and changing owner:group to www-data:www-data.

# Create the /var/www folder and reassign ownership of the folder (and any files/subfolders)
sudo mkdir /var/www
sudo chown -R www-data:www-data /var/www

Get the latest version of Apache2 from the Debian repository:

# Update repository information
sudo apt-get update
# Install Apache
sudo apt-get install apache2

The "apache2" package requires the installation of a slew of additional packages (often called "dependencies"). Press "Y", then "enter" (or just "enter", as "Y" is the default response), and sit back while the "apt-get" package manager does its thing. Towards the end of the install, you should see a few lines that look like this:

Setting up apache2-mpm-worker (2.2.16-6+squeeze7) ...
Starting web server: apache2apache2: Could not reliably determine the server's fully qualified domain name, using 127.0.0.1 for ServerName.
Setting up apache2 (2.2.16-6+squeeze7) ...

This is a sign of a successful install!

Testing Installation

You should now have an operational Apache2 web server! There are a few ways to test this:

  • From the web server
    • command line
# Use a basic Internet tool to download the web server's starting page
wget http://localhost/ ~/
# Use your eyeballs to compare the source file with the downloaded file
cat /var/www/index.html
cat ~/index.html
  • GUI (untested)
  • Open the web browser (probably Midori)
  • Browse to the following URL:
http://localhost/
  • You should see the following text (except with a bit more formatting):
It works!
This is the default web page for this server.
The web server software is running but no content has been added, yet.
  • From another computer, using a web browser
    • Get the web server's IP address
ifconfig eth0
# Sample output from the previous "ifconfig eth0" command
eth0      Link encap:Ethernet  HWaddr b8:27:eb:9b:03:55
          inet addr:192.168.2.123  Bcast:192.168.2.255  Mask:255.255.255.0
          UP BROADCAST RUNNING MULTICAST  MTU:1488  Metric:1
          RX packets:17360 errors:0 dropped:0 overruns:0 frame:0
          TX packets:4789 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:11645538 (11.1 MiB)  TX bytes:443716 (433.3 KiB)
The IP address of the default network card is listed after the "inet addr:" title. (In my example above, the IP address of my web server is "192.168.2.123". Write down the IP address of your web server - you're going to use it during the next step
  • Browse the web server from another computer using a GUI
  • Open the web browser
  • Browse to the following URL:
http://<ip_address_of_web_server>/
  • You should see the following text (except with a bit more formatting):
It works!
This is the default web page for this server.
The web server software is running but no content has been added, yet.