Skip to content

Installation

Calin Crisan edited this page Aug 31, 2015 · 22 revisions

Requirements

  • a machine running a recent Linux distro
  • python 2.7
  • tornado 3.1+
  • jinja2
  • PIL or pillow
  • 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.

There are three major versions of motion:

  • The stable version (3.2.12 at the time of writing) is included with most distros, but is highly outdated and lacks features like RTSP camera support. The source code can be downloaded from here. It's important to note that this version uses an older configuration file format, incompatible with newer ones (supported by motionEye, nevertheless).

  • The SVN version (r564 at the time of writing) lives in this repository. The SVN version is newer and may perform better in some situations but seems to be less stable. The development here seems to be discontinued.

  • Mr-Dave's version can be checked out here. This is probably the most up-to-date, featureful and stable version, itself being forked from sackmotion repository.

Read the Compiling Motion page if you want to manually compile any of these versions.

Install Instructions

motionEye releases are uploaded to PyPI, so you can use the pip 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: 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.

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):

http://[your_ip]:8765/

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

Upgrading

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.

Clone this wiki locally