-
Notifications
You must be signed in to change notification settings - Fork 908
FAQ
- Hardware
-
Options & Configuration
- What are the default web UI credentials?
- What's the deal with Snapshot URL, Streaming URL and Embed URL?
- How can I enable authentication for the MJPEG stream?
- What should I do to have pictures attached to motion notification emails?
- Why does system keep rebooting, in a loop?
- How can I recover/reset the admin password?
- How can I make motionEyeOS save more than one picture in a second?
-
Software Updates
- How can I update my motionEyeOS setup to the latest version?
- Where's my
Checkbutton for automatic updates? - Will the automatic update preserve my settings?
- I have started the update process several minutes ago and it still hasn't finished. What should I do?
- The automatic update is not available for me or it failed to apply. What are my options?
- I noticed a new version has been released. Why does my motionEyeOS say it's up-to-date?
- Command Line & Shell Access
- Various
Short answer: no. Long answer: normally all USB cameras that are supported on Linux (have a v4l driver) should work with motionEyeOS. Board-specific cameras (such as the Raspberry PI CSI camera) should also work. If you're on Raspberry PI, all cameras supported by Raspbian are supported by motionEyeOS as well.
Short answer: no. Long answer: normally all WiFi adapters that are supported on Linux should work with motionEyeOS. If you're on Raspberry PI, all adapters supported by Raspbian are supported by motionEyeOS as well.
Just open the settings panel and, under the Expert Settings section, turn off the Enable CSI Camera Led option.
The LED option only works for Raspberry PI boards equipped with first generation official/genuine CSI camera modules.
In the settings panel and, under the Expert Settings section, turn off the Network Link Watch option.
I don't buy boards just to port motionEyeOS on them. If you really want me to try to port motionEyeOS to your favorite board, feel free to send me one and I'll do my best to make motionEyeOS run on it. Also please note that I won't return it to you, given that once motionEyeOS is available for that platform, I'll use it to test new builds.
Use admin with no password.
Snapshot URL serves a single JPEG file when requested. The served JPEG image is always the most recently captured frame. You can use this URL as the src attribute of an <img> HTML tag but keep in mind that it won't update automatically. You shouldn't use this unless you know what you are doing.
Streaming URL provides MJPEG streaming. It can be used as a source for other applications that deal with video streams and know how to handle MJPEGs, or it can be used as the src attribute of an <img> HTML tag.
Note: Internet Explorer doesn't support MJPEG streams at all; Chrome plays them nicely if they are part of a web page but won't display anything if the streaming URL is entered directly in the address bar.
Embed URL provides a complete standalone HTML document (i.e. web page) that can be opened in most modern browsers and that will refresh automatically. Think of it as the camera frame part of the UI without any surrounding elements. You can use this to embed the stream into another web page, using an <iframe> HTML tag.
In the Video Streaming section of the settings panel, you'll find a combo allowing you to choose an authentication mode. Use either Basic or Digest, depending on your application. The credentials are those configured for the surveillance user.
Just enable still images and set Capture Mode to Motion Triggered. Also make sure to configure Attached Pictures Time Span to a reasonable amount of seconds (5 to 30).
On slower systems you may see the following line showing up in logs:
[sendmail] ERROR: timeout waiting for the media listing process to finish
If you see this message, clean up your media folder by removing older files; the media listing process will then have to deal with fewer files and will hopefully do its job in time.
See System Continuously Rebooting.
Unfortunately there's no easy way to recover or reset your admin password. You'll need a computer running Linux and capable of mounting your ext4 partition from the SD card. Identify the data partition (normally the largest one) and look for the file /etc/motion.conf. Just clear out the value at the end of the line starting with # @admin_password.
The default file name pattern used when creating pictures is %Y-%m-%d/%H-%M-%S. This pattern generates the same file name for all pictures created within a second. If you want all the pictures that are generated within a second, just modify the pattern so that it contains %q, which is the frame number inside each second (e.g. %Y-%m-%d/%H-%M-%S-%q).
If you're lucky and you have motionEyeOS installed on one of the boards with automatic update support, you'll find a Check button next to the Software Update settings item, in the settings panel.
The updating process is always started by you and is never done automatically. It will first check for new stable versions and, following your confirmation, it will download and apply the update.
Currently, automatic updates are available only for the Raspberry PI and Raspberry PI 2 boards. If you don't see that button, you probably run motionEyeOS on another board.
Yes, the automatic update process will preserve all of your settings and media files that are saved on the SD card.
I have started the update process several minutes ago and it still hasn't finished. What should I do?
The update process may take a considerable amount of time, being influenced by factors like your network connection's speed, the performance of your SD card, as well as the CPU speed. Expect it to be ready within 5 minutes, but don't interrupt it before a half an our.
If after 30 minutes it still hasn't finished, chances are that something went wrong. You can either login and access the shell to inspect the /var/log/motioneye.log file to see what went wrong, or you can install the new version manually.
If you don't care about your previous settings and media files saved on the SD card, you can proceed with installing the new version from scratch. If you want to preserve your settings (and media files), you'll need to make a backup of your SD card's data partition (you'll probably need Linux for that), and restore it later, after you have manually installed the new version.
You can create a backup of your settings, so that you can restore them later if you're forced to write the OS image from scratch.
Either the new version is marked as pre-release (i.e. it still needs some testing before going stable) or the new version is simply not available for your board. If you really want to upgrade to a pre-release, just turn Enable Prereleases on in Expert Settings.
motionEyeOS listens on the standard port 22, if you want to use SSH. Use root or admin as username (admin is just an alias for root) and the password that you set for the administrator in the web UI. By default (when the administrator's password is empty), you won't be prompted for a password.
Also keep in mind that passwords are applied at boot so your new password will be fully effective only after a reboot.
motionEyeOS is not a general-purpose Linux distribution. You can't install packages like you do with a normal distro. If you need to further customize your setup, installing motionEye on a common distro is recommended.
motionEyeOS is not a general-purpose Linux distribution. If you want to run a command with sudo, you probably found it online and most likely it won't work on motionEyeOS. Moreover, sudo helps you run commands as root; if you have successfully logged in to a motionEyeOS shell, you already are root.
Both the boot and the root partitions are mounted read-only to prevent filesystem corruption. If you want to make changes to a file on any of these two partitions, re-mount them as writable:
mount -o remount,rw /
mount -o remount,rw /boot
motionEyeOS will never display anything beautiful on your monitor - it is meant to only be used from a web browser. The ugly text that appears on the monitor is actually useful when debugging. Most users should ignore it and access the IP address of their motionEyeOS board from the browser.
motionEyeOS uses port 80 for its web user interface and this is enough for most users. You may however want to open the following ports as well:
- 808x for directly accessing the MJPEG stream of the camera number x (e.g. 8081 for your first/only camera)
- 22 for SSH/putty access
- 21 for FTP access
Please keep in mind that it is not recommended to enable port forwarding from a public IP address to your motionEyeOS machine directly on these ports. Instead you should use some other ports (e.g. 8888 for the web user interface) and forward it internally to the actual port(e.g. 80). The reason is that port 80, as well as port 22, are subject to various attacks which, even if they fail, may slow down your motionEyeOS machine.
See Reporting An Issue.