Picture of Raspberry Pi as low-cost HD surveillance camera
This instructable describes how to build a surveillance cam based on a Raspberry Pi micro-computer which records HD video when something moves in the monitored area. Live picture can be viewed from any web browser, even from your mobile while you're on the road.
What you will get:
  • See live stream in any web browser from anywhere
  • Record any motion into video file
Usually, such a cam will cost you around US$1.000, but with the result from this instructable, you will get such a cam for only about US$120.

Step 1: Background

Picture of Background

Have you ever heard of Raspberry Pi? It's a low-cost micro-computer that is able to run Linux and has endless extension possibilities. It cost only about US$35 and opens up endless possibilities of what you can build with it. The official website can be found at http://www.raspberrypi.org/

Step 2: Hardware components

Picture of Hardware components

We need some hardware for this project. This is a list of the major things we need:

  • Raspberry Pi Model B: This is the larger model of the Raspberry computer system with 700MHz and 512MB Ram. It supports HD video. You can easily order it from i.e. here. Cost: about US$40. You could also use the Raspberry Pi Model A which is slightly cheaper and consumes less energy. Stefan Knight has written an excellent article on how to run this whole project on a model A.
  • A housing for the camera: you don't need to buy a high-price-housing for your Raspberry. There are loads of very cheap fake security cameras available which perfectly fit our needs here. Search the web for "surveillance camera dummy" and you will find loads of housings for your new camera for only a few dollars. I.e. this one will do the job: http://amzn.to/15XLaAj for only US$9. We have ordered this camera housing for about 20€ in Germany that had enough space for all the components:http://amzn.to/19CTEaN. You can use any camera housing, but only be careful about the size of the housing so that the Rasperry board will fit in there. The dimensions of the Raspberry board are 85.6 x 53.98 x 17 mm (approx 3.37 x 2.13 x 0.67 in).
  • Power supply: The Raspberry computer does not come with any power supply, you have to get one on our own. Any power supply with a micro-USB plug can do the job as long as it supplies at least 1A of power. We have ordered such a power supply which already has a micro-USB plug for about US$10
  • SD card: as the Raspberry Pi does not have any storage on board, you need to add some so that you can install and run the operating system for this device. Any SD or microSDHC should do the job, but we recommend using a Class 10 SD card. It's only around US$7
  • To connect this cam to your network, you also need some kind of network connection. One possibility is to use a LAN connection, but you would need to put LAN cable to the point where you want to mount the camera. A better alternative is such a WiFi USB adapter for only about US$10
That's all: for about US$120 we have all the hardware we need to build this HD surveillance cam.

Step 3: Install Raspbian

At first, you should install the OS and software to the Raspberry Pi before mounting it all together. An OS is the basic operating system software that tells the Raspberry hardware what to do. Linux is perfect for this. We have chosen Raspbian, as it's one of the most advanced OS for the Raspberry with loads of help and tutorials on the internet.
You need to prepare the SD card to be able to run Raspbian on the Raspberry: this excellent tutorial from Adafruit will explain the necessary steps.
Now temporarily connect your Raspberry Pi board to LAN cable, a monitor (HDMI TV works out of the box, but a HDMI-to-DVI cable like this will do the job as well) and a USB keyboard for the basic setup.
Insert the prepared SD card with the Raspbian installer on it and attach the power supply.
The Raspberry should boot up and guide you through the setup process as explained in this Adafruit tutorial. After this, you should have a basic Raspbian OS running.
Be sure to enable SSH in Raspbian so that you are able to control the Raspberry device also when there is no monitor and keyboard attached. And you should also enable the camera from the Raspbian setup menu so that we can use it for motion detection.
Now make sure your RPI is up to date:

sudo apt-get install rpi-update
sudo rpi-update

And also update all packages:

sudo apt-get update
sudo apt-get upgrade

Step 4: Connect via SSH

Picture of Connect via SSH

Now that the basic setup is done, you should connect to your Raspberry device from your computer. You can connect to Linux console from any computer in your local network and control it like you where sitting directly in front of it. This is very important as once mounted far away from your desktop, you need to be able to make updates and change the configuration of this camera any time later without the need to detaching it from the wall and bringing it back to your desk.

Remember that this cam is not just a dump cam device but a very powerful computer with Linux OS running on it. It's not limited to what we explain in this article now; it will follow any development in software so that you will be able to install updated software and more modules any time later.

First, you need a software to connect to the Linux console on the Raspberry. For Windows, you will need the extra (free) software PuTTY. Download it from the PuTTY website, install it and connect to your Raspberry Pi device:

From now on, you don't need any monitor and keyboard attached to the Raspberry anymore.

Step 5: Enable WiFi

If you want to run this camera with a WiFi USB dongle (like we've suggested in step 2), you will need to do some quick additional steps to make WiFi work on the Raspberry:
From the console (PuTTY window), edit the network properties of the Raspberry:
sudo nano /etc/network/interfaces 
Now add these lines at the end of the file (or change existing lines to match these):
allow-hotplug wlan0 
iface wlan0 inet dhcp 
(Fill in the SSID and password for your WiFi network)
Reboot the Raspberry with this command and see if it correctly connects to your WiFi network:
sudo reboot  

Step 6: Put the hardware together

Picture of Put the hardware together
Now it's time to assemble all the hardware components together into the housing. Depending on the housing, this should not be a too complicated job. Be sure to mount the Raspberry board safely so that it doesn't tumble around in the housing.
As our housing had a very large glass window at the front, we have closed it with a black paper with a hole in it. This has the advantage that the "tech" of the camera is not visible anymore. If you like the camera recording led to be visible, don't cover it. Whenever the camera is detecting any motion or is recording, the led light will glow in a very bright red.
You can also turn off the camera red LED by adding this line to /boot/config.txt:


Step 7: Installing the motion detection software

A very good (and free open-source) motion detection/surveillance software with many configuration options is motion.
We now need to install it using the command line (log in to your raspberry as user "pi"):
sudo apt-get install motion 
Some packages will be installed in the installation process; just type "y" to proceed with the installation.
As the current version of motion does not (yet) support the Raspberry camera module, we need to download and install a special build with support for this camera module.
cd /tmp 
sudo apt-get install -y libjpeg62 libjpeg62-dev libavformat53 libavformat-dev libavcodec53 libavcodec-dev libavutil51 libavutil-dev libc6-dev zlib1g-dev libmysqlclient18 libmysqlclient-dev libpq5 libpq-dev
wget https://www.dropbox.com/s/xdfcxm5hu71s97d/motion-mmal.tar.gz  
And now you need to unpack the downloaded file to the /tmp directory:
tar zxvf motion-mmal.tar.gz  
After this unzipping, you now need to update your installed motion with the downloaded build:
sudo mv motion /usr/bin/motion
sudo mv motion-mmalcam.conf /etc/motion.conf  
You also need to enable the motion daemon so that motion will always run:
sudo nano /etc/default/motion
and change the line to:
We're pretty sure that the official build of motion will shortly also support the Raspberry camera module as well.
A very important command to edit the motion configuration file is
sudo nano /etc/motion.conf  
Note: in the standard motion installation, the motion.conf is in /etc/motion/, but in the special motion-mmal build from dropbox-url (see above) it's in /etc/. If you follow this tutorial with all steps, this is no problem at all.
Be sure to have the file permissions correct: when you install motion via ssh while being logged in as user "pi", you need to make sure to give the user "motion" the permissions to run motion as service after reboot:
sudo chmod 664 /etc/motion.conf
sudo chmod 755 /usr/bin/motion
sudo touch /tmp/motion.log
sudo chmod 775 /tmp/motion.log  
We've made some changes to the motion.conf file to fit our needs. Our current motion.conf file can be downloaded here. Just download, unzip and copy the containing motion.conf to /etc/motion.conf if you would like to use the exact config options we describe below.
Some of the main changes are:
Make sure that motion is always running as a daemon in the background:
daemon on 

We want to store the logfile in /tmp instead (otherwise autostart user won't be able to acces it in /home/pi/ folder):

logfile /tmp/motion.log
As we want to use a high quality surveillance video, we've set the resolution to 1280x720:
width 1280
height 720 
We don't need real-time video, 2 pictures per second are totally ok for our needs:
framerate 2 
This is a very handy feature of the motion software: record some (2 in our configuration) frames before and after the motion in the image was detected:
pre_capture 2
post_capture 2 
We don't want endless movies. Instead, we want to have max. 10 minutes slices of the motion videos. This config option was renamed from max_movie_time to max_mpeg_time in motion. If you use the motion-mmal build, this one will work. If you get an error 'Unknown config option "max_mpeg_time"' either change this one to max_movie_time or make sure to really use the motion-mmal build as shown above.
max_mpeg_time 600 
As some media players like VLC are unable to play the recorded movies, we've changed the codec to msmpeg4. Then, the movies play correctly in all players:
ffmpeg_video_codec msmpeg4  
Enable access to the live stream from anywhere. Otherwise only localhost (= the Raspberry device) would be allowed to access the live stream:
stream_localhost off 
If you want to protect the live stream with a username and password, you should enable this:
stream_auth_method 2  
stream_authentication SOMEUSERNAME:SOMEPASSWORD 
All configuration parameters are explained in detail in the motion config documentation.
After your changes to the motion.conf, reboot the Raspberry:
sudo reboot  
After the reboot, the red light of the camera module should be turned on, which shows that motion currently is using the camera to detect any movement.

Step 8: Save videos on Windows shared folder

As the SD card of the Raspberry Pi is a pretty limited resource, we've decided to let the Raspberry cam store the videos on one of our Windows Servers. This is pretty easy:
First share a folder from some Windows machine. Just follow some guides on the internet if you've never shared a folder from a Windows machine before.
Then open the fstab configuration on your Raspberry from a PuTTY console or directly from the device:
sudo nano /etc/fstab  
Now add an extra line with the configuration of your Windows network shared folder:
//YOURSERVERNAME/YOURSHAREDFOLDERNAME /mnt/camshare cifs username=YOURSHAREDFOLDERUSERNAME,password=YOURSHAREDFOLDERPASSWORD,iocharset=utf8,file_mode=0777,dir_mode=0777 0 0 
Be sure that the user has the correct permissions to save files to that shared folder.
After a reboot, the Raspberry should have an extra folder /mnt/camshare mounted to the Windows shared folder. You should now set in your motion.conf:
target_dir /mnt/camshare 
so that motion saves all movies to the shared folder on the Windows machine.

Step 9: Fix motion autostart

Picture of Fix motion autostart
We had some trouble that motion was not automatically started on a reboot of the Raspberry. We've found out that this was because the mounted folder of the Windows machine was not yet ready when motion tried to access it.
A very quick fix solved our problem:
Just edit the motion file with
sudo nano /etc/init.d/motion 
and add the line
sleep 30 
to the start-sequence.
Our changed /etc/init.d/motion script can be downloaded from here.

Step 10: Mounting the camera

Picture of Mounting the camera
After all these steps, you can finally mount the surveillance camera to the destination point.
Some helpful hints:
  • Be sure to place the power supply in a dry and safe place
  • Keep an eye on the WiFi signal: if you mount the camera out of range of the WiFi, it won't be able to send any live video nor save any motion videos

Step 11: Accessing the live stream

Now you can access the live stream from the camera from any browser via the url http://IPADDRESSOFRASPBERRY:8080
Where 8080 is the port that we've configured for our stream in the motion.conf file. See your own configuration setting "stream_port" in motion.conf for the port.
We've found out that Google Chrome 30 (not even on iOS) wasn't able to play this stream directly due to a bug in the underlying Chromium project.
A workaround for this is to create a simple html file that contains one large image with the stream-url of the camera. See the file cam.html from raspberry_surveillance_cam_scavix.zip. This way, Chrome can show the live stream as well. Let's hope that Chrome will fix this issue in their browser.
But other browsers like FireFox, Safari and even VLC media player was able to show the live stream of the camera.
We were not able to make the live stream work in Internet Explorer as it doesn't support Motion JPEG. Kenneth Lavrsen (the maker of motion) has described workaround for live stream in Internet Explorer here.

Step 12: Access live stream from anywhere

Picture of Access live stream from anywhere

To make the live stream accessible from anywhere, you will need to enable some kind of dynamic domain services to your local network. This will enable you to always be able to connect to your local IP address from the outside even if your local IP address changes (over here in Germany, every private DSL ip address changes every 24 hours).
Such a (free) service enables you to access your Raspberry from anywhere even if your ip address changes. A very good service we're using for some years now is dyn.com. They have some free services and are integrated in many routers.
Once you have set up the dynamic ip url, you can access the camera stream from anywhere in your browser (i.e. http://YOURDYNAMICDOMAIN:8080).
And this also works from the browser on your mobile device.

Step 13: Next steps

There are a thousand things you can do with such a surveillance cam basic setup now. How about sending Growl notifications when some motion was detected? This guide explains how to add this functionality easily.

Or you could easily add a temperature-sensor to the cam. It's only a few bucks and can be integrated very easily.
We're currently working on integrating the live stream into MediaPortal server so that we can switch to a TV channel to see the live stream from the cam in our office.

If you want extra security, you could also add a battery pack to the camera. Be sure to buy one that is able to charge simultaneously while powering the Raspberry. This would enable you to detect if some bad guy cuts the power strips of your camera and send some alert messages to you (i.e. SMS or email) including the video of the disturber.

What are you going to add? Let us know!

1-40 of 339Next »
KavierS3 days ago

If i have wpa2, do i need to write: wpa2-ssid "my netwoer ssid" and wpa2-psk "wifi pass"?

ConnorB814 days ago

Should my /etc/default/motion file be blank?? When I entered that command it is a completely blank file and I'm not sure if the instructions are telling me to modify a line of the code or are telling me to write a new piece of code

dr.m.hajarat5 months ago

I bought a WiFi wireless camera for $75. The Raspberry Pi camera module alone is $65.... so doing this to save money is not wise. If you want to do it, do it because you want to, not because you will save money.

The RPi camera sells for less than $25 on Amazon. Also, the WiFi camera you bought likely is low resolution 240p or 480p. You are also handcuffed by the features of the camera's software. RPi solution is versatile and you can use your imagination, research your ideas, and come up with a solution that you want.

JasonS47 JimC916 days ago

and you can use the pi for other things. I am using this same pi to play music from my library over speakers in my garage and plan on controlling my garage door with this same pi.

I don't know where you found the pi camera module but it is way cheaper than $65

Very good little project. I finally have it working with some workarounds. I found that having the Raspberry Pi powered from a plug pack 15 metres from the Rpi would not work consistently so it is powered by 12v via a Turnigy 3A UBEC and it is fine now. The only problem I have now is that the PC folder won't mount and share automatically and I have to log in to the RPi and issue a mount -av command after it boots up. Will try and work out why this is so.

Great work.

This may be because fstab is kicking off before your wifi has initialized and has an IP. Therefore it cant reach the server. Just something to look into....

NigelS21 month ago

Would like to start and stop motion manually rather than on start-up. Not sure how to do it?

OwenB5 NigelS21 month ago

sudo /etc/init.d/motion start

sudo /etc/init.d/motion stop

MixMedia1 month ago
I am getting an error, please help
OwenB5 MixMedia1 month ago

You have merged two separate commands onto one line.

Run this first:

sudo apt-get install -y libjpeg62 libjpeg62-dev libavformat53 libavformat-dev libavcodec53 libavcodec-dev libavutil51 libavutil-dev libc6-dev zlib1g-dev libmysqlclient18 libmysqlclient-dev libpq5 libpq-dev

Then run the second command:

wget https://www.dropbox.com/s/xdfcxm5hu71s97d/motion-mmal.tar.gz

gangrel1441 year ago

I read over there this:

We don't need real-time video, 2 pictures per second are totally ok for our needs

But can i get real-time video? or What is the maximum framerate for the raspberry pi?

first tell me if your working on ssh

zbot473 zbot4731 month ago


CédricV21 month ago

Instead of motion you can also use Kerberos.io, it's also open-source and a lot more user friendly to install and configure. You can find more information on the website.

you pay for it

zbot4731 month ago

what abt mac

zbot4731 month ago


NigelS21 month ago

seems like a great project which I have tried on a RPi B but have 2 problems...

1) Rather than go straight to saving on a server I have tried to save locally first just to get things shaken out. So in /etc/motion.conf I set target_dir /home/pi (also tried target_dir /home/pi/Cam1). But no files are saved. I know motion detect is working as the LED goes out when I move something in front of the camera, also each time movement is detected a new entry is created in /tmp/motion.log.

2) I can see the video stream at //ipaddress:8080 just fine until motion is detected at which point the stream goes down. Repeatable 100%.

So from the above I know the camera works, the motion detect works but file saving and streaming does not.

Has anyone seen this on a RPi B or otherwise and got it to work?

NigelS2 NigelS21 month ago

OK, solved: for motion to write to the local /home/pi directory a

'chmod 777 /home' and 'chmod 777 /home/pi' gave it appropriate permissions. This also solved 2) above as the stream was crashing each time motion failed to write to is target_dir.

Its my first project with an RPI. Installed all the software like described in the tutorial. When trying to access the camera in a browser the live stream is shown for only 2-3 seconds then in breaks down. Any ideas ?

but I don't use a windows server how so I make it work in linux?

I am currently having this issue as well. Did you find a fix for it?

masoudh5 months ago

Hi .

i did l steps and service motion run corectly but camera led is off and anything on ip !

[-1242975368] [NTC] [ALL] [Mar 26 19:26:48] motion_startup: Using log type (ALL$

[1] [ALR] [VID] [Mar 26 19:26:48] mmalcam_start: MMAL Camera thread starting...$

[1] [ALR] [VID] [Mar 26 19:26:48] mmalcam_start: MMAL Camera using video capture

[1] [ALR] [VID] [Mar 26 19:27:01] MMAL Camera cleanup

NateJO96 masoudh2 months ago

I had this issue for a while too. I accidentally had the camera cable lpugged in backwards. Once the camera is plugged in correctly, type sudo raspi-config, select the option mentioning the Raspberry Pi Camera, and select enable. After that, select finish, and it should reboot.

RodR32 months ago

By default the log and picture/video files are kept in /tmp. I learned the hard way that this directory is purged on every reboot.

Either move it to somewhere else or edit /etc/default/rcS

and change TMPTIME to some other days to keep value

CédricV23 months ago

Instead of motion you can also use Kerberos.io, it's also open-source and a lot more user friendly to install and configure. You can find more information on the website.

ProfetaJonas3 months ago

Can't see a dadasdnasdmn shizzle.

Hello can i connect more then one cam to the kerberos on the Rasberry pi

a have 6 cam's ?

RazvanV3 months ago

username: pi

password: raspberry

PatrickB193 months ago

I've got everything working, except when I try to view my live stream in Firefox, the stream shows for 2-3 seconds then i get an error message that says "The image cannot be displayed because it contains errors." I get a similar issue with Safari and on my iphone. I've tried lowering the resolution of the capture, but that did not help. Any suggestions? Thanks!

JoaoZ3 months ago

Great stuff :)

Is this working in Raspberry Pi 2 Model B?

scavix (author)  JoaoZ3 months ago

As the Pi2 is backwards-compatible, it should work on it as well. But we haven't tried yet. Could you please share the results after your tests?
kziol3 months ago

Thanks. I made this project and I can save the files to a computer on the network, and I can save the files to an SD mounted using a USB adapter while the Raspberry Pi is on the network. I want to be able to save the files just to the SD card when the Raspberry Pi is not on the network. I modified the following entries in motion.conf:

#text_right %d,%m,%Y\n%T commented out line

#text_left HofCam commented out

#text_event %Ym%d%H%M%S commented out

snapshot_filename %v-snapshot

picture_filename %v-%q

movie_filename %v

timelapse_filename %v-timeplace

however, this doesn't work. I don't see anything useful in the log files. Has anyone made this project saving the files to an SD card not connected to a network? Thanks.

ChakkaY4 months ago

Guys I got following error while installing motion detection software from wget https://www.dropbox.com/s/xdfcxm5hu71s97d/motion-... this link:

The certificate of `www.dropbox.com' is not trusted.

The certificate has not yet been activated

Plz help me....what should i do now

scavix (author)  ChakkaY3 months ago
You can also use
wget http://www.scavix.com/files/motion-mmal.tar.gz
MichaelS664 months ago

The back of my house has a place for a light, high up above the door, but it only has two wires coming out of the house. What can I buy in order to power the Pi with those two wires, without having to install an outdoor electrical socket? I have looked around online, but only ever find a standard two-pronged usb power plug. Thanks!

AnishP4 months ago

This instructable is awesome. But I am stuck at one step which I haven't been able to solve yet.

I tried to access the stream from outside my network by registering for a Dynamic DNS through No-ip. I haven't been successful at it. Is there a link that describes the process accurately?

Does it require port forwarding?

scavix (author)  AnishP4 months ago
Yes, you need to forward the port for the stream (i.e. 8080, see your own configuration setting "stream_port" in motion.conf for the port) in your router so that you can access the Pi from outside of your local network.
See port-forwarding documentation of your internet router.
1-40 of 339Next »