MotionEye Docker Configuration

This project sets up a MotionEye container using Docker to monitor cameras. MotionEye is a web-based frontend for motion, which is a software motion detector for Linux. With this setup, you can easily manage and monitor your cameras via a web interface.

Prerequisites

Docker installed on your system
USB camera or other supported camera devices
Basic familiarity with Docker and Docker Compose

Getting Started

Clone this repository to your local machine:

git clone https://github.com/samsesh/motioneye-docker-compose.git
cd motioneye-docker-compose

Configure the docker-compose.yml file to specify the desired settings for your MotionEye container, including camera devices and ports.
Start the MotionEye container using Docker Compose:
```
docker-compose up -d
```
Access the MotionEye web interface by opening a web browser and navigating to http://localhost:8765.

How to Find a USB Camera

To find the correct /dev/videoX device associated with your USB camera, follow these steps:

Open a terminal window on your machine.
Plug in your USB camera.
Run the following command to list the available video devices and their associated names:
```
v4l2-ctl --list-devices
```
This command will display a list of video devices along with their names. Look for the entry that corresponds to your USB camera.

Example output:
```
USB Camera (usb-camera):
    /dev/video0
```
Note down the /dev/videoX device associated with your USB camera and its name.
Update your MotionEye Docker Compose configuration (docker-compose.yml) with the correct /dev/videoX device. For example, if your USB camera is associated with /dev/video0, and its name is "USB Camera," you would add it to the devices section of the configuration:
```
devices:
  - /dev/video0
```
Save the updated docker-compose.yml file and then start the MotionEye container using Docker Compose:
```
docker-compose up -d
```

Your MotionEye container should now use the correct /dev/videoX device associated with your USB camera based on its name.

Configuration

You can customize the MotionEye configuration by editing the docker-compose.yml file. Ensure that you map the correct /dev/videoX device for your camera and adjust other settings as needed.

Usage

Access the MotionEye web interface to configure and monitor your cameras.
MotionEye allows you to set up motion detection, schedule recordings, and more.

Maintenance

To stop the MotionEye container, run:
```
docker-compose down
```
To update the MotionEye container to the latest version, run:
```
docker-compose pull
docker-compose up -d
```

Troubleshooting

If you encounter issues or need assistance, please refer to the MotionEye documentation or seek help in the MotionEye community.

License

This project is licensed under the MIT License.

Contributions and Donations ❤️

We greatly appreciate contributions and support for this project. Should you find value in this endeavor, please consider contributing or donating to assist us in maintaining and enhancing it.

Feel free to show your support via the following donation link: Donate

Your contributions enable us to continually improve the security and functionality of this project.

samsesh / motioneye-docker-compose