Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Write The OS Image
All releases are available from here and are marked by date.
download the latest stable release called
motioneyeos-[board]-yyyymmdd.img.gz, where [board] is the name of your board
extract the image file from the archive
write the image file to your SD card:
If you use Windows, just follow these instructions.
If you use Linux or OSX, there's a writeimage.sh script that will do everything for you, including the optional setup of a wireless network connection and setting a static IP address. Just run the script as follows (replacing the arguments with appropriate values):
./writeimage.sh -d /dev/mmcblk0 -i "/path/to/motioneyeos.img"
note: specify the device path to the disk and not to some partition (e.g.
You can preconfigure a wireless network connection:
./writeimage.sh -d /dev/mmcblk0 -i "/path/to/motioneyeos.img" -n 'yournet:yourkey'
If you prefer a static IP instead of DHCP, just run the following command:
./writeimage.sh -d /dev/mmcblk0 -i "/path/to/motioneyeos.img" -s "192.168.1.101/24:192.168.1.1:184.108.40.206"
Any other image writing method should work, including using the Unix
When booting a fresh image installation, a few initialization steps will take place and therefore the system won't be ready for about 1-2 minutes. Please do not disconnect or reboot your board during these first two minutes!. These steps are:
- preparing the data partition on the SD card
- configuring SSH remote access
- auto-configuring any detected camera devices
Of course your motionEyeOS needs an IP address before you can communicate with it so you'll have to use the ethernet connection with DHCP enabled, unless you have preconfigured a static IP address.
As soon as your motionEyeOS is ready it will listen on port 80 and present you a web user interface. To access it, enter the IP address of your board in the address bar of your browser. To find the address, connect to your router (most routers can display the addresses of all connected devices) and look for a device name beginning with "meye-". Alternatively, you can use a network scanner such as the free mobile app
Click on the user icon on the upper-left side of the page to switch user to administrator. Use
admin with no password when asked for credentials. Feel free to explore all the available configuration options.