Installation

This page describes the installation of a prebuild image. If you want to compile an image by your own see Building an Image.

1. Download the latest stable release for your device

2. Extract the image file from the archive

3. 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 setup of a wireless network connection and configuration of the dav server credentials. Just run the script as follows (replacing the arguments with appropriate values):

    ./writeimage.sh -d /dev/mmcblk0 -i "/path/to/photos.img.xz" -n 'YOURSSID:YOURKEY' 
   

   Note: Specify the device path to the disk and not to some partition (e.g. /dev/mmcblk0 instead of /dev/mmcblk0p1).

4. Configure photOS (not needed if image was written to SD card using writeimage.sh):

   1. Mount first partition (usually /dev/mmcblk0p1)

      Note: Partition should be automatically mounted on Windows when reinserting the SD card

   2. Create file wpa_supplicant.conf and add your wifi credentials:

       update_config=1
       ctrl_interface=/var/run/wpa_supplicant
       network={
         scan_ssid=1
         ssid="YOURSSID"
         psk="YOURKEY"
       }
      

   See Wifi for additional details on Wifi configuration.

5. After first boot, photOS greets you with a placeholder image and points you to the URL of the webui, were the system can be configured (e.g. WebDAV credentials and operation schedule).