Calin Crisan edited this page Jan 24, 2017 · 17 revisions


  • a machine running a recent Linux distro
  • python 2.7
  • tornado 3.1+
  • jinja2
  • PIL or pillow
  • curl, libcurl & pycurl
  • motion (optional)
  • ffmpeg (optional)
  • v4l-utils (optional)

The Motion Daemon

The motion daemon itself is optional, but needed in most cases. Install it (along with ffmpeg and v4l-utils) unless you configure a machine that will only act as a hub for other motionEye-based cameras.

Install Instructions

motionEye releases are uploaded to PyPI, so you can use the pip (or pip2) command to install it as well as (some of) its dependencies. Following are detailed instructions for some common distributions.

note 1: The given commands normally need to be run as root; type them in a root shell or use sudo before each command.

note 2: On systems where Python3 is the default Python interpreter, you should use the pip2 command instead of pip.

note 3: If you are configuring a motionEye system that will only act as a hub for other motionEye-based cameras (i.e. no locally connected cameras and no IP cameras), you can skip installing motion, ffmpeg and v4l-utils.

Choose one of the following specific install instructions. When you're done, you may want to come back here and read on to find out how to access the frontend or how to update your motionEye.

Accessing The Frontend

After having successfully followed the installation instructions, the motionEye server should be running on your system and listening on port 8765. Fire up your favorite web browser and visit the following URL (replacing [your_ip] with... well, your system's IP address):


Use admin with empty password when prompted for credentials. For further details on how to configure motionEye, see Configuration.


Upgrading should be as easy as running the following command (as root):

pip install --upgrade motioneye

To upgrade to a specific version (say 0.27.1), use:

pip install --upgrade motioneye==0.27.1

If you have manually downloaded and installed motionEye, the pip command above won't work and you'll need to repeat the manual installation procedure, preserving the configuration directory.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.