Table of Contents

Install Lomorage Service on Raspberry Pi

To run on Raspberry Pi, you need to order a Raspberry Pi, we have tested the image the following models:

If you don’t have one yet, we would recommend the newer version, which gives better performance. The minimum set you need includes:

  • Raspberry Pi board
  • Power supply
  • 16GB MicroSD card

A Raspberry Pi 3 B+ (PLUS) Starter Kit is good enough for the setup.

There are 3 options to install Lomorage service on Raspberry Pi, one is using the prebuild OS image which has all the dependencies installed, or you can run docker image on your existing running Raspberry Pi, or if you can just use APT install.

Install with prebuild OS image

The prebuild image includes all Lomorage packages, including:

  • lomo-backend: Lomorage service backend

  • lomo-web: Lomorage web application

  • lomo-base: network configure tool, button control, hard drive mount tool (usbmount modification), bluetooth console

  • lomo-frame: the digital frame application

Click the link below to download the prebuild OS image.

Raspberry Pi

After you download the customized OS image, you can install the image to MicroSD card using balenaEtcher, which is available on both Windows and macOS.

After you insert the MicroSD to your desktop or laptop, just select the image you download, choose the MicroSD drive, and click “Flash”, it will be done in a few minutes.

After flushing the image, insert the microSD into Raspberry Pi board, connect USB hard drive with Raspberry Pi, plug in a network cable, plug in the power supply, turn on the power and wait a few minutes for system boot.

If you have HDMI connected, after system boot successfully, it will show up a screen that no able to find any assets. You can upload photos using Lomorage Phone app, and then press “r” to rescan. If you want to quit to terminal to do some configuration, just press “ESC” and then “Ctrl+Alt+F2”, after you made any changes and want to start lomo-frame, use command sudo service supervisor restart.

The default login username is “pi” and password is “raspberry”

We suggest use cable to provide better performance, but if you prefer to use WiFi, you can login Raspberry Pi and use the command client "wifi-ssid" wifi-password, replace “wifi-ssid” and “wifi-password” with those of your wifi network. Make sure you have quotation mark around “wifi-ssid” if you have space or unicode character in it, for example client "Lomorage's 2.4G" mypassword.

Docker installation

Docker installation is convenient way if you don’t want to mess thing on existing system. It doesn’t support Raspberry Pi 0 and 1 now.

Docker image includes:

  • lomo-backend: Lomorage service backend

  • lomo-web: Lomorage web application

1. Install Docker on Raspberry Pi

note: If you are using OMSC, you need to change “id=osmc” in “/etc/os-release” to “id=raspbain”

sudo apt install -y ca-certificates
sudo update-ca-certificates --fresh
curl -fSLs | sudo sh
sudo usermod -aG docker $USER
sudo systemctl start docker

2. Get Docker image

Pull from docker hub.

sudo docker pull lomorage/raspberrypi-lomorage:latest

3. Run


You can specify the media home directory and lomo directory, otherwise it will use the default, you MUST specify the host, subnet, gateway, network-interface, vlan-address. [-m {media-dir} -b {lomo-dir} -d -p {lomod-port} -P {lomow-port} -i {image-name}] -h host -s subnet -g gateway -n network-interface -a vlan-address

Command line options:
    -m  DIR         Absolute path of media directory used for media assets, default to "/media", optional
    -b  DIR         Absolute path of lomo directory used for db and log files, default to "/home/jeromy/lomo", optional
    -h  HOST        IP address or hostname of the host machine, required
    -s  SUBNET      Subnet of the host network(like, required
    -g  GATEWAY     gateway of the host network(like, required
    -n  NETWORK_INF network interface of the host network(like eth0), required
    -a  VLAN_ADDR   vlan address to be used(like, required
    -p  LOMOD_PORT  lomo-backend service port exposed on host machine, default to "8000", optional
    -P  LOMOW_PORT  lomo-web service port exposed on host machine, default to "8001", optional
    -i  IMAGE_NAME  docker image name, for example "lomorage/raspberrypi-lomorage:[tag]", default "lomorage/raspberrypi-lomorage:latest", optional
    -d              Debug mode to run in foreground, default to 0, optional

    # assuming your hard drive mounted in /media, like /media/usb0, /media/usb0
    ./ -m /media -b /home/pi/lomo -h -s -g -n eth0 -a

You can add the command in “/etc/rc.local” before “exit 0” to make it run automatically after system boot.

Apt installation

If you have the official Raspbian image installed already, APT installation would be the quickest way to install.

1. Add lomoware source

sudo apt install -y ca-certificates python-certifi python3-certifi
sudo update-ca-certificates --fresh
wget -qO - | sudo apt-key add -

If you are using jessie:

echo "deb jessie main" | sudo tee /etc/apt/sources.list.d/lomoware.list

If you are using buster:

echo "deb buster main" | sudo tee /etc/apt/sources.list.d/lomoware.list

then run:

sudo apt update

2. Install Lomorage

You need at least lomo-vips and lomo-backend installed.

  • lomo-backend: mandatory, Lomorage service backend

  • lomo-web: optional, Lomorage web application

  • lomo-base: optional, network configure tool, button control, hard drive mount tool, bluetooth console

  • lomo-vips: mandatory, lomorage vips clone. (A fast image processing library with low memory needs), used by lomo-backend

  • lomo-frame: optional, the digital frame application

sudo apt install lomo-base lomo-vips lomo-backend lomo-web lomo-frame -y

3. Change mount directory and username if needed

You may need to specify the mount directory if the USB drive is not mounted in “/media” directory.

For example if you are using PCManFM, then the mount directory will be “/media/pi”. To specify the mount directory to be “/media/pi”, modify ExecStart in “/lib/systemd/system/lomod.service”, and add parameter “–mount-dir” as below

ExecStart=/opt/lomorage/bin/lomod -b /opt/lomorage/var --mount-dir /media/pi  --max-upload 1 --max-fetch-preview 3

If your username is not “pi”, you need to change “User=pi” in “/lib/systemd/system/lomod.service”, and use your username.

Make sure the user has the r/w permission for the “mount-dir” set above

4. Run

Restart Lomorage service:

# restart lomo-backend
sudo systemctl restart lomod

# restart lomo-web
sudo systemctl restart lomow

# restart lomo-frame
sudo service supervisor restart