Installation

Requirements

• a machine running a recent Linux distro
• python 2.7 & pip2
• 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: pip2 is no longer installed from your distro's repositories. The latest version can be installed using the following instructions:

      curl https://bootstrap.pypa.io/pip/2.7/get-pip.py --output get-pip.py
      python2 get-pip.py

note 4: 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.

• Install On Debian 10 Buster or Earlier
• Install On Debian 11 Bullseye or Later
• Install On Ubuntu (19.10 or Earlier)
• Install On Ubuntu (20.04 or Newer)
• Install On Raspbian 10 Buster Legacy or Earlier
• Install On Raspbian 11 Bullseye or later
• Install On Fedora
• Install On Arch
• Install On Other Distributions
• Manual Download And Installation

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.