Build a Raspberry Pi Webcam Server in Minutes

by Gus

Updated Jan 23, 2023

This Raspberry Pi webcam server tutorial will take you through on how to have your very own Webcam that is visible on a web page.

If you’re after more of a security like system, then check out the Raspberry Pi security camera tutorial as it features fully-fledged web streaming, motion detection, recording and multi-camera functionality.

This tutorial is marked intermediate as it can be challenging to get working especially if you have hardware that differs to the versions used in this tutorial. If you find that you can’t get this to work, then the security camera solution linked above is much easier to get going.

Equipment

Below are some of the pieces of equipment that you will need to be able to complete this tutorial.

Optional

Video on Setting up the Webcam

If you’re more of a visual person and would prefer to watch how to set this up, then you check out my video below. If you like the video, then please subscribe to me, so you’re kept up to date with all the latest videos.

Unfortunately, the video is now out of date and uses an older method then what’s explained in the text version of this tutorial. I highly recommend that you follow the written tutorial, while I work to update the video.

How to Setup a Raspberry Pi Webcam Server

Firstly, we will need to install Raspbian onto the Raspberry Pi. If you haven’t already done, this then check out my awesome guide on installing NOOBs Raspberry Pi. It will take you through all the steps that you will need to do to get up and running.

In this tutorial, we will be using a package called Motion if you want to learn more about it you can check out their website at Motion.

Since the latest version of Raspbian is missing dependencies that Motion requires for it to work correctly, we will need to install a different precompiled version.

The package maintainer (Currently: Mr Dave | Previously: Calin Crisan) of Motioneye provides a package that has everything we need, and it works just fine with the Raspberry Pi.

1. We will be using the terminal, so open the terminal on the Pi or connect to it via SSH.

2. To begin, first, update the Raspberry Pi, so you’re running on the latest version.

sudo apt update
sudo apt upgrade

Depending on the version of Raspbian you’re using you will need to do some different steps. For this tutorial, we will be installing Motion for Raspbian Buster. If you’re not already on it then I highly recommend that you upgrade.

3. First, install the following packages. This command will work both on the full and lite version of Raspbian Buster.

sudo apt install autoconf automake build-essential pkgconf libtool git libzip-dev libjpeg-dev gettext libmicrohttpd-dev libavformat-dev libavcodec-dev libavutil-dev libswscale-dev libavdevice-dev default-libmysqlclient-dev libpq-dev libsqlite3-dev libwebp-dev

4. Next, download the Motion deb file for Raspbian Buster from GitHub using the wget command and install it using the dpkg command.

sudo wget https://github.com/Motion-Project/motion/releases/download/release-4.5.1/$(lsb_release -cs)_motion_4.5.1-1_$(dpkg --print-architecture
).deb

sudo dpkg -i $(lsb_release -cs)_motion_4.5.1-1_$(dpkg --print-architecture).deb

That’s all you need to do before moving on to configuring Motion so that it will run on your Pi.

Configuring Motion

1. Now we need to make some edits to the configuration file, motion.conf.

sudo nano /etc/motion/motion.conf

2. Find the following lines and ensure that they are set to the following values.

daemon off
stream_localhost off

Note: Change the following two lines from on to off if you’re having issues with the stream freezing whenever motion occurs.

picture_output off
movie_output off

Optional (Don’t include the text after the #)

stream_maxrate 100 # This change will allow for real-time streaming but requires more bandwidth & resources. Needs to be added to the config file, default is 1
framerate 100 # Changing this option will allow for 100 frames to be captured per second allowing for smoother video, default is 50
width 640 #This line changes the width of the image displayed, default is 640
height 480 #This option changes the height of the image displayed, default is 480

Altering these options can drastically affect the performance. You may need to tinker to get the best results.

3. Now, we need to enable the Motion service by running the command below.

Using this command will make Motion start up when your Raspberry Pi powers on.

sudo systemctl enable motion

4. Once you’re done, simply save and exit by pressing CTRL + X then Y.

5. Now make sure the camera is connected and run the following line:

sudo systemctl start motion

6. If you need to stop the service, simply run the following command:

sudo systemctl stop motion

7. Now you should be able to check out the Webcam Stream at the IP address of our Pi so in your browser go to the following address.

192.168.1.103:8081

8. If the web page isn’t loading, try restarting the service.

sudo systemctl restart motion

9. If you’re using a Raspberry Pi camera, then you will need to do a few extra steps that are mentioned below.

There we have it a fully working Raspberry Pi Webcam server that you can place wherever you would like (Given it is within WiFi range) and be able to view the stream via the web browser.

If you want to allow external access to the camera, then check out my instructions towards the bottom of this tutorial.

Extra Steps for the Raspberry Pi Camera

If you want to use the Raspberry Pi camera module, then you will need to do a few additional steps to set it up.

Installing the Hardware

1. First, go to the CSI (Camera Serial Interface) ribbon cable slot on the Pi and with two fingers on each side of the connector pull up. This technique should now open the connector, now insert the ribbon cable with the metal leads facing away from the Ethernet Port.

2. Once you have lined it up gently press the connector back down and the cable should now be locked in one place.

Configuring the Software

To get the Raspberry Pi camera to work with Motion, we will need to do a few extra steps.

1. First make sure the camera is switched on within raspi config, enter the following command and then enable the camera (Found in interfacing options). You will need to restart once you have done this.

sudo raspi-config

2. Enter the following line to had the camera to modules. Make sure the camera is connected correctly before running this line otherwise it will thrown an error.

sudo modprobe bcm2835-v4l2

3. Alternatively, the following process should also work. First, open up the modules file by entering the following line.

sudo nano /etc/modules

4. Enter the following line at the bottom of the file if it doesn’t already exist.

bcm2835-v4l2

Once done, save and exit by pressing CTRL + X then Y.

5. Now reboot the Pi, and the stream should now work.

sudo reboot

6. You should now be able to access the Raspberry Pi webcam stream by going to the Pi’s IP address on port 8081.

192.168.1.103:8081

You should now have a fully working Raspberry Pi camera server that is accessible within your local network. If you want to allow external access to the camera, then please follow my instructions below.

Saving Motion Footage and Photos

By default, you will likely run into permission problems for saving the photos and video triggered by motion. I will go through the steps below on how to set this up to work correctly.

1. Firstly, let’s make a new directory for our photos and videos.

sudo mkdir /motion

2. Next, we need to change the group of the motion folder so motion can write into it. After that, we give the group; read, write and execute permissions using the chmod command.

sudo chgrp motion /motion 
sudo chmod g+rwx /motion

3. We now need to go back into the motion configuration file and change the target_dir to our new directory. First, open up the file with the nano text editor.

sudo nano /etc/motion/motion.conf

4. Update the target_dir line, so it looks like the one below.

Make sure you remove the ; from the start of the line.

target_dir /motion

5. Next, restart the motion service, so the configuration is loaded correctly.

sudo systemctl restart motion

6. Now, whenever the camera detects motion, it should be saved into the folder we specified above. You can check this by running the following command.

ls /motion

Be sure to check out our Linux permissions guide for more information on setting permissions correctly.

Setting Up External Access

In order to enable external access to the Raspberry Pi webcam server, we will need to change some settings on the router. However, all routers are designed differently so you may need to look up instructions for your brand of router.

Please note, opening ports to the internet comes with a security risk.

If you need a more in-depth guide, then be sure to take a look at my guide on how to set up Raspberry Pi port forwarding and dynamic DNS.

The following steps are what I did on mine in order to get it to work. My router is an AC1750 TP-Link Router.

1. Go to the router admin page (This will typically be 192.168.1.1 or 192.168.254)

2. Enter the username and password. Default typically is admin & admin.

3. Once in go to forwarding->Virtual Server and then click on add new.

4. In here enter:

Service port: In this case 48461
IP Address: 192.168.1.103 (Address of your Pi)
Internal Port: We want this to be the same as the webcam server so make it 8081
Protocol: All
Status: Enabled

5. These settings will route all traffic destined for port 48461 to the webcam server located at the IP address and port you provided. For example: 192.168.1.103:8081

6. You should now be able to connect to the Raspberry Pi webcam stream outside your network. You may need to restart the router for changes to take effect.

If you’re unable to connect outside your local network then you can try the following.

Check your router settings and confirm they are correct.
Check your IP hasn’t changed. Some internet service providers will provide you with a dynamic IP rather than a static IP) You can set up something called dynamic DNS to counter this you can find out more information via the link mentioned above.
Restart the router.

I hope that you have enjoyed this tutorial on how to build a Raspberry Pi webcam server if you want more then, please check out all my Raspberry Pi projects I currently have completed. There will be much more coming in the future.

300 Comments

Jim on August 11, 2016 at 3:24 am

Gus,
I seem to have to unplug and then plug-back-in (re-plug?) the USB camera if I reboot the pi. Is this normal behavior? And if so, is there a work around?
THANKS!
J

Reply
Jim on August 4, 2016 at 9:27 am

Oh… and by the way THANK YOU!!!!
This is the best DYI site yet!!!!

Reply
1. Gus on August 4, 2016 at 3:54 pm
  
  Editor
  
  Thanks 🙂
James on August 4, 2016 at 9:06 am

I there a way to disable just the motion activated recording. I still want the snapshot feature but my memory is getting filled up to fast.

Reply
1. Gus on August 4, 2016 at 4:03 pm
  
  Editor
  
  Looking through the settings.
  
  Switch this option to off will stop the program recording/saving video.
  
  ffmpeg_output_movies on
  
  Switching this on will snap pictures whenever motion is detected.
  
  output_pictures on
  
  Following will take a picture regardless of motion being detected.
  
  snapshot_interval 0
  
  Hope that helps, the page below might also help you. It contains all the options with descriptions.
  
  https://motion-project.github.io/motion_config.html
2. James on August 5, 2016 at 2:06 am
  
  Gus,
  
  Switch this option to off will stop the program recording/saving video.
  ffmpeg_output_movies on
  
  Will the above stop the timelapse? I would like to still collect time lapse.
  
  Thanks again…
3. Gus on August 5, 2016 at 2:10 am
  
  Editor
  
  It shouldn’t stop the timelapse but I haven’t been able to test it.
Jim on August 4, 2016 at 8:30 am

If I have set up port forwarding correctly in my router… what address should I enter when outside my network…
Yea… I’m new at this!
THANKS

Reply
1. Gus on August 4, 2016 at 3:51 pm
  
  Editor
  
  You should enter your external IP followed by the port you have forwarded. To find your external IP just google “My IP” whilst on your home network. The address you plug into your browser should end up looking something like this xxx.xxx.xxx.xxx:port_number
2. Jim on August 5, 2016 at 1:24 am
  
  Thanks Gus…
  Was your choice of port 48461 arbitrary?
  Thanks!
3. Gus on August 5, 2016 at 1:50 am
  
  Editor
  
  It was arbitrary but i made sure it was above 0-1023 because these ports are reserved (Well known ports/System Ports).
Rajitha on July 31, 2016 at 7:07 pm

hey when i try “./motion -n -c motion-mmalcam.conf” it gives an error called “error while loading shared libraries: libavformat.so .53: cannot open shared object file : no such file or Directory” can any one help me please.

Reply
1. Gus on August 3, 2016 at 6:54 pm
  
  Editor
  
  This is a known issue, Raspbian removed the required libraries when they updated it from Wheezy to Jessie. I haven’t been able to work out a workaround yet unfortunately.
Davide on July 27, 2016 at 2:36 am

Hi, how can I record video file and stream on the website at the same time?

Reply
Ivaylo on July 26, 2016 at 4:38 pm

Hello Gus,

thank you for this great tutorial . As you probably already know , the new motion comes with RTSP streaming feature . Could you please explain how to make RTSP Stream using motion ? Thank you in advance.

Reply
JonDoe297 on July 9, 2016 at 2:44 pm

Hi

I have a Raspberry Pi 2 Model B and a normal camera module. I’m stuck at step number 9. When I type ./motion -n -c motion-mmalcam.conf , I get an error saying “./motion error while loading shared libraries: libavformat.so.53: cannot open shared object file: No such file or directory” . I open it from mmal directory. i’m a newbie to Raspberry Pi. Please help. Thanks.

Reply
1. justin on July 13, 2016 at 9:32 pm
  
  Try
  sudo apt-get install libavformat-dev
JayTee on July 5, 2016 at 12:57 am

Hi,

Great work. I have one question. Will the audio microphone work too or
is it just video?

Reply
1. Gus on July 6, 2016 at 5:56 pm
  
  Editor
  
  Just video.
Bill on June 25, 2016 at 3:06 am

It works, but only for a few seconds. I’m using a webcam. If I “sudo service motion restart”, then it works again for a few seconds. Any ideas on how to keep the video stream going?

Reply
1. Gus on June 26, 2016 at 10:20 pm
  
  Editor
  
  I am unsure what could be causing this. It’s most likely an unstable driver for the Webcam. Can you please let me know what kind webcam you’re using and Ill look into it.
2. Raul Munif on December 22, 2017 at 5:34 pm
  
  Hi Gus, This is amazing it works like a charm! Is there any way that we can set it up to save to a location as well as streaming?? E.g so we can monitor the stream while also having the video saved to a location?? If I go on holiday and set up my pi security camera, come back to being robbed, is there anyway to see the robbers. Basically a playback function
3. Gus on December 29, 2017 at 2:33 am
  
  Editor
  
  Hey Raul,
  
  I recommend checking out our Raspberry Pi Security Camera Network tutorial, this shows you how to install a more fully featured piece of software that from memory allows you to actually record the stream, and add things such as motion detection.
  
  Cheers
Tony R on June 22, 2016 at 9:13 am

I have a question, I can’t seem to find a straight answer on the web, I have my raspberry pi with a usb cam on it for a weather cam. But I also have a windows machine broadcasting a bird feeder cam. I can’t figure out / or find out how to get the weather cam to broadcast at the same time, no matter what I do with the linksys router, nothing allows that second camera out of the house…
Thanks if you are able to help

Reply
Sergan on June 16, 2016 at 4:51 pm

Hi,
Nice project you have there. 🙂

I need some help.
I want my pi cam server using login and logout before take to Ip address. (without motionpie)
can you help me. Sorry for my bad at English.

Reply
Krisztián Balázs Farkas on May 28, 2016 at 7:02 pm

Hello everyone,

Fist of all thank you for the guide, it’s awesome.

I had hard times to get this work. At the end what helped me was: sudo motion
I’m not 100% sure why it’s did not work out without that, but this did the trick for me. Hope it helps someone.

Reply
1. Krisztián Balázs Farkas on May 28, 2016 at 7:42 pm
  
  Furthermore, I found out with sudo services motion status that I had no write privileges to the folder where it wanted to save the files… It’s also worth to check if you have difficulties 🙂
abhijeet awasthi on May 26, 2016 at 3:49 pm

Hey Gus,

first of all it was really helpful tutorial.But i’m having some difficulties in setting up that webcam server.It works well for a while for about 25 seconds then it is getting stopped then i have to give start command again . are there any changes which i can make in motion.conf file to fix this up.
thanks,hoping for reply

Reply
Quintin on May 22, 2016 at 10:01 am

Hi there! Thanks for this! Is there any way we can include audio as well? It seems a bit of a waste to have the mic on the webcam and then not use it.

Reply
Rob on May 20, 2016 at 4:40 am

This was exactly what I needed! Thank you for taking the time to put these instructions together!!

Reply
Pramod on May 2, 2016 at 1:39 am

Thanks for the steps. Very helpful.I wanted to clarify what you mean by outside network? It means form anywhere in the world?

Reply
Farid on April 26, 2016 at 8:09 pm

hi guys i got some problem,
it didnt work on my raspberry pi 3,i used logitech webcam and i have do sudo service motion start.and when i go to my browser and typ ip:8081 it refuse to connect 🙁

Reply
Parker Hemming on April 19, 2016 at 2:04 pm

Everything seemed to be working fine, but when I opened it up in the browser (chrome) by using ***.***.*.**:8081 it said unable to open video device. Before it also said in the browser that there was an error capturing the first image… I’m not sure what to do. Please Help Gus!
I’m stuck at this point

Reply
Ryan on April 13, 2016 at 3:58 pm

This is great, however how could I place this live feed on a html page? What additional code if any would be needed?

Reply