Picture of Raspberry Pi Web Server
Hi there,
This is my first Instructable so all criticisms and comments are welcome.
This will show you how to set up a simple wired web server on your Raspberry Pi, with PHP and MySql.

The Raspberry Pi is a good choice for a webserver that will not recieve too much traffic, such as a testing server, or small intranet, as it doesn;t get too hot (so is nice and quiet), and only uses around 5 Watts of power (costing £3.50 a year where I am if it's running 24/7)

In the future I might add how to set up a wireless server.

If you have any problems, post them in the comments, or PM me - I'm happy to help.
Remove these adsRemove these ads by Signing Up

Step 1: You will Need

Picture of You will Need
PuTTY download.png
To create a simple web server, you will need:

1. A power supply (Micro USB)
2. A network cable
3. A HDMI cable (or Component cable) as well as a screen and USB keyboard
3. A Raspberry Pi
4. An SD card (2GB or more)
5. An SD card reader for your computer
6. Win32DiskImager (For Windows) or dd (for Unix)
7. The Raspberry Pi Debian Image
8. PuTTY (For Windows) or any other SSH client
9. Around an hour of free time

You can download the software from the following locations: (for Win32DiskImager) (Debian Image) (for PuTTY)

Step 2: Format SD Card

Picture of Format SD Card
Select Image.png
Selected Image and SD card.png
Firstly, you need to install the Debian image onto an SD card (2GB or more).
(The image can be downloaded from

You can do this using the Win23DiskImager tool for Windows (downloaded from

Insert your SD card.
Once you have downloaded the above, Extract the Debian image, and the Imaging tool, then run Win32DiskImager.
Ignore the error that you will see.
Select the Image file (debian6-19-04-2012) and your SD card, then click "Write", it will ask you to confirm, click "Yes". Then enjoy a break, as it usually takes a couple of minutes to write.

Once the write process has finished, you can remove the SD card, then the fun begins.
1-40 of 227Next »
dale3h2 years ago
Just wanted to share my experience with this Instructable. Everything went smoothly until it was time to connect to MySQL from a remote machine on the same network. So here's how to fix that:

1. Grant access to your remote machine using: GRANT ALL ON *.* TO 'root'@'192.168.1.%' IDENTIFIED BY 'your_password_here'; (I used 192.168.1.% so that any computer on my network can connect to it)
2. Go into the my.cnf file (sudo nano /etc/mysql/my.cnf) file and look for "bind-address" and comment this out (put a # in front of the line)
3. Reload MySQL config (service mysql reload)
4. Restart MySQL server (service mysql restart)

Hope this helps, and thank you for the great Instructable :)
diy_bloke dale3h9 months ago

is the "GRANT ALL ON *.* TO 'root'@'192.168.1.%' IDENTIFIED BY 'your_password_here';"
a command you type into the terminal? or does it go into some config file?
btw, I can advise anybody using a remote linux server (like the Raspberry) to install 'webmin' as well

You get an SQL type console when you type "mysql -p -u root" which accepts SQL code like the GRANT. the rest is all normal console code :) btw, what a coincidence to see you here as well!

thanks. :-) small world :-)

well all went great with the server and it still works, just somehow the terminal program doesnt accept my login anymore :-) I know th epassword is right as I still can get in through 'Webmin'

drcurzon (author)  dale3h2 years ago
Hi there,
Thanks for posting this to help others :)
Good work, thanks
d00nald21 days ago

can you use this server rechable external network, and register .com to that?

please let me know, thanks!

José MaríaS2 months ago


I'm just trying to install mysql on my raspberry pi B+ with no success.

When I try to install: sudo apt-get install mysql-server

I've got always a message that mysql failed to start.

I looked around the internet and tryed several "solutions" but nothing worked.

I've installed last raspbian version on my SD.

Can you or anyone help me. Thank very much in advance.

José María Sánchez

Ibiza - Spain

bmccaig4 months ago
where can i find a version of debian, the link provided does not work?
Gelfling6 bmccaig2 months ago

You should be able to grab the Raspian image from the Raspberry Pi main website, and make the changes listed here. Though, in this instructable, he suggests a 2GB CF card, I highly recommend an 8GB or higher, as the latest images seem to be larger once they expand. Jump to for the images.

puihuenlaw3 months ago

I don't know why i have this problem. After I add a "#" in "/etc/passwd". I followed your steps and enter the command: "usermod -d /var/www pi". But it said "user 'pi' does not exist. Can anyone help me??


For some weird reason, I found that the line he wants you put a # in front of, doesn't actually exist.

If you're like me, you probably put the hashtag in front of the wrong line.


This line is weirdly not the same line as the one in the tutorial, though it does resemble it.

The line in the tutorial is this:

pi:x;1000:1000:Raspberry Pi User,,,:home/pi:/bin/bash

What I did, is I actually made a new line and wrote in the line we were supposed to hashtag, then I un-hashtagged the line that was already there when I opened the file.

It looked like this in the end:

pi:x;1000:1000:,,,:home/pi:/bin/bash (Pre-existing line)

#pi:x;1000:1000:Raspberry Pi User,,,:home/pi:/bin/bash (Line I wrote in)

It seemed to fix the issue.

It doesn't make scenes because the "#" sign is for disabling the following line without deleting it. If you just put a new line:

pi:x;1000:1000:,,,:home/pi:/bin/bash (Pre-existing line)

#pi:x;1000:1000:Raspberry Pi User,,,:home/pi:/bin/bash (Line YOU wrote in)

The # sign doesn't do anything for you. (It didn't disable the pre-existing line)

I thought this tutorial is outdated so the code is not suitable for Raspberry Pi B+. I just skipped that command and go straight. And it goes right!

In addition, I found a app called "WebIOPi". It is more convenient to use GPIO in the web and over the web.

gago.babic.33 months ago

can I ask. i have basic php site. and i want to have password . so only me have acess to site. I am turning lights over internet and right now enybody can do this. can you tell me how can i protect site . I am beginer so....

HowardC53 months ago

Tried several suggestions, aidenv5's recommendation solved the problem. Thanks aidenv5. Here is his recommendation.

To log in again using the user pi you need to add that user to the group pi.

ssh to pi with user root

type sudo useradd -g pi pi

type passwd pi

type new UNIX password/confirm

type exit

type exit

DavidM483 months ago

If you are having issues with running php, just run sudo chmod -R 755 /var/www/

It fixes an issue where php would not run.

XanderA14 months ago

Thanks for this, just what I needed.

DanishR4 months ago

Yes it works, works perfectly... Was getting few errors in the middle but than i realized i missed few steps.

Anyone interested in adding reset switch to Raspberry Pi

inteldon4 months ago

Someone needs to update this instructable. So many people are complaining about the # and other minor settings. Please update with corrections.

inteldon4 months ago

I followed this tutorial. By the end of it I could no longer log into my RPi using remote desktop! It didn't recognize my root account or pi account. When I tried to use the browser I did get the "It works!" page from apache, but when I tried accessing the /phpmyadmin I got banned for inserting the wrong password. I did enter the right password I created when I was setting it up. I tried restarting the RPi but had the same problems again. Please help!

CharlesS55 months ago

I don't think this insctructable is very detailed nor accurate at times. A lot the steps are just given with out any justification especially as the steps proceed toward the end, which can leave you in some tight spots. Commenting out my pi user made me panic before I knew to relogin as root. At times it can be confusing and not clear exactly how to reach a particular checkpoint of a step. For instance change host name should mention the difference between eth0 and wlan0. Also accessing your apache server has to do with you IP and not the entered in hostname. There are also better ways to do things in my opinion such as phpmyadmin 'sudo apt-get install phpmyadmin.' I just think for someone getting into web development this tutorial is nice in that it lays out on the software you need to host your own server but there are simpler better ways that won't leave you guessing why the %$^# you just did that.

cozghes5 months ago


everything went well, but when i try to connect the ip on my browser not work.
anyone can help me?
davidbarcomb6 months ago

Clear and concise. Great instructable!

winrish016 months ago

mv boot_enable_ssh.rc boot.rc

this command is not working showing no such files or directory

help me out plzz ASAP..

I had to use "sudo /etc/init.d/ssh start" instead and it worked fine

winrish016 months ago

after all this steps when I open putty and enter host name and press open

it shows "connection refused"

can any one help me out ?//

Im trying to login to putty and it says connection refused...

GalenA17 months ago

How to gain access to root again

do NOT remove the # in front of the pi password

login as pi

type sudo -i (gives root w/o passwd)

type passwd


verify password


oululife7 months ago

Good writeup.
I did much the same, but used lighttpd as the server. Also couple of recommendations:

If my host machine is running Linux, not Windows, try PACmanager as an alternative to putty. Bit more friendly.
At some point, do a "sudo rpi-update" to make sure your firmware's gets extra goodies to the camera, etc. Needs a reboot afterwards.
Load Filezilla on the host machine! Saves a lot of messing about!
If you want to put the machine on the web, checkout (I might write an 'instructable' for this, it's fairly easy, but...
Anyway, has been running this, only interrupted when we had to decorate, for over a year without any downtime.

New to using the Pi. When I enter the command "ifdown eth0" I receive an error saying interface eth0 no configured.

Is this also causing me to get the Network Error:Connection refused?

Hello there,

eth0 connection is a connection via Ethernet cable, if you are using a WiFi dongle, type in wlan0 instead.

I recommend typing in "sudo ifdown wlan0 && sudo ifup wlan0" instead as it put both command together so you can reconnect if your doing the commands remotely.

New to using the Pi. When I enter the command "ifdown eth0" I receive an error saying interface eth0 no configured.

Is this also causing me to get the Network Error:Connection refused?

mikak28 months ago

I was able to log in as root after restarting the raspberry. Then I removed the # added for user pi. After that user pi was found again.

LeonardoR28 months ago

Typo after closing nano: "service" instead of "servce"

WouterD made it!8 months ago

For installing PHPMyAdmin you should follow this tutorial, much easier and it WORKS. Great tutorial though.


You can use your Banana Pi also as a Webserver / FTP Server:

itsleif1 year ago
I followed the steps, all works fine, but now I cannot log in any more. After restart the pi user login does not work and the new password does not work either. I also tried the root user with both passwords the old and the new, nothing works.

No I cannot log in my pi any more :( I cannot change the password file either because my mac does not mount the linux partition...

how can login again?
MattC1 itsleif9 months ago

remove the # infront of pi:x;1000:1000:Raspberry Pi User,,,:home/pi:/bin/bash

Ok but how to remove ? Because while adding I was connected with SSH. now can't connect with SSH so ... ?

1-40 of 227Next »