Installation Guide

Installation Guide

1. Overview

To use Lomorage, you need to run the Lomorage service in your local network, either on Windows, OSX or Raspberry Pi. And then you need to download the client APP at the APP store.

2. Download

Lomorage Service

You can choose which version of Lomorage to download based on your preference. Running Lomorage service on Windows or OSX gives you better performance compared with on Raspberry Pi, the uploading and accessing the backup will be faster, but running Windows or OSX is not energy efficient as using Raspberry Pi. If using Raspberry Pi, you don’t need to worry about the electricity bill, it is only about 5$ a year

Windows   macOS   Raspberry Pi

Lomorage client

Curently support iPhone and iPad。

Download on the App Store

3. Setup

The first step is to set up the Lomorage service.


1. double click “lomoagent.msi” to start installation。If Windows Defender shows “lomoagent.msi” as unknown application, please follow the steps below to allow it to run。

2. Follow the wizzard to finish the installation, in the End-User License Agreement, please checked the box as below。

3. Now you should see the lomoagent icon on your desktop, you can double click to start the lomoagent. If you meet below dialog popuped up by the Windows os, please select “Private networks …” one and click the Allow access.

4. You will see below picture while you start the lomoagent, You need to config the “Data directory” before using it,”Data directory” is used to save the photos and videos uploading from your phone。


1. Double click “LomoAgent.dmg” to start installation, and follow the steps below to finish the installation。

2. Run LomoAgent Application,please allow network access for LomoAgent if firewall is triggered。

3. After launch the Lomorage application,You need to set the “Home directory” before using Lomorage,”Home directory” is used to save the photos and videos uploading from your phone。You can also set up a backup directory which served as redundancy backup.

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 two options to install Lomorage service on Raspberry Pi, one is using the prebuild OS image which has all the dependencies installed, another one is manaully installation if you already have Raspberry Pi setup and running for other purpose.

Install with prebuild OS image

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.

We strongely suggest use cable to provide better performance, but if you prefer to use WiFi, you can login Raspberry Pi and use the command wifi_switch client [wifi-ssid] [wifi-password], replace “[wifi-ssid]” and “[wifi-password]” with those of your wifi network.

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

Install on existing Raspbian

step 1. Add lomoware source

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

step 2. Install 3rd party tools

sudo apt install ffmpeg rsync jq libimage-exiftool-perl -y

step 3. Install file systems support

sudo apt install nfs-common exfat-fuse ntfs-3g hfsplus hfsutils hfsprogs -y
sudo ln -nsf /bin/ntfsfix /sbin/fsck.ntfs
sudo ln -nsf /bin/ntfsfix /sbin/fsck.ntfs-3g

step 4. Install usbmount

You can skip this if you are using desktop image which has PCManFM installed that can auto mount the USB drive. If you are using the Lite image, and you can use usbmount to auto mount the USB drive.

The usbmount we are using is a modified version which mounts a specfic USB drive to a fixed mount point in “/media” directory, which means the order you plugin the drives doesn’t matter, the mount point is always the same.

sudo apt install lockfile-progs -y
sudo mkdir /etc/usbmount
sudo mkdir /usr/share/usbmount
sudo wget -qO /etc/usbmount/usbmount.conf
sudo wget -qO /usr/share/usbmount/usbmount
sudo chmod +x /usr/share/usbmount/usbmount
sudo wget -qO /etc/udev/rules.d/usbmount.rules
sudo wget -qO /etc/systemd/system/usbmount@.service

step 5. Install Lomorage service

sudo apt install lomo-vips lomo-backend -y

step 6. Change mount directory if needed

If you are not using the usbmount in step 4, 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 paramter “–mount-dir” as below

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

Then restart Lomorage service:

sudo systemctl restart lomod


You can install the application on either iPad or iPhone, the minimum iOS version required in 10.3. Since it’s currently in beta testing using testflight, user needs to download testflight first, and then install Lomorage in testflight. Drop us an email to request testflight access.

After launching Lomorage, it should be able to discover the Lomorage service running in the same network. If you have multiple Lomorage service instances running, those will be listed and you can choose one to use. If Lomorage service can’t be discovered automatically, you can discover the service via QRCode Scanning when using Windows or MacOS LomoAgent (open settings in LomoAgent to show the QRCode), or you can input the IP address and port manually.

Then you can create user, choose the place you want to store your photos on the Lomorage service, after login, it will take a few minutes to import all your photos on phone, and then you can drop down to start uploading the photos to the place you choose to store your backup, if the photo uploads successfully, there will be a green check on the bottom right. The remote tab will show you those photos stored remotely but not exists locally, so if you delete your local photo that already backup successfully, it will show up in the remote tab view.

4. External Access

Currently, external access need some manual setup and some technical background, we will make the process more user-friendly later.

There are a few tunnel services available for free use, most tunnel services require a client application running on your device, and set up a connection to the service running by the service provider, and it will give a subdomain name for you to use, if you access the URL with that subdomain, the tunnel service will forward the traffic/request to the client application.

You can use localtunnel or ngrok, both are free tunnel services. localtunnel doesn’t require registration, and it can customize the subdomain, so it’s pre-installed in Lomorage Raspberry Pi image, while ngrok need register before use, and need pay to customize subdomain, but it’s more stable and zero dependencies.

If you are using Lomorage Raspberry Pi image, the login username is “pi” and password is “raspberry”


If you are using Windows or macOS, you need to install nodejs first and then install localtunnel. If you are using Lomorage Raspberry Pi image, then you can run command sudo to install localtunnel, and you can skip step 1 an step2.

1. Install nodejs

Download and install the binaries in your platform.

2. Install localtunnel

Open the terminal and type

npm install -g localtunnel

3. Run localtunnel

Assuming the preferred subdomain name is “allice” (you can choose your own subdomain), then open the terminal and type:

lt -s allice -p 8000 --print-requests

”-s” specify the subdomain to use, “-p” specify the port forward to, Lomorage service is using “8000” by default, and “–print-requests” will output coming requests.

And if you see the output without any error message, and print out something like:

your url is:

Then you can start open that URL in your browser, and if you see requests log printing in localtunnel output, then the tunnel is set up successfully.

Sat Aug 31 2019 11:38:00 GMT-0700 (PDT) GET /

4. Config tunnel service on Lomorage APP

Open Lomorage APP on the phone, and in the settings tab, fill the tunnel service host and port, the host is like “”, and the port is “443”.


1. Register

Sign up a ngrok account here, after that, it will show up a “Setup & Installation” page.

2. Download

ngrok is just one binary, you can download the version on your platform.

If you are on Raspberry Pi, you can copy the link of Linux(ARM) on the “Setup & Installation” page, which is “" for now, and download it via “wget”.


3. Installation

unzip and get the binary. You can double click on Windows or macOS to unzip it.

If you are using Raspberry Pi, use “unzip” command:


4. Connect your account

On the “Setup & Installation” page step 3, it shows the “authtoken”, you need open terminal to run ngrok to add the authtoken to the config file.

./ngrok authtoken [your-authtoken-show-in-step-3]

5. Run ngrok

Lomorage service is using “8000” by default, and ngrok can’t customize subdomain with free account. After runnig successfully, it will show the tunnel url, the subdomain is a random string which might change in next run.

./ngrok http 8000

6. Config tunnel service on Lomorage APP

Open Lomorage APP on the phone, and in the settings tab, fill the tunnel service host and port, the host is like “”, and the port is “443”.

Icons made by Freepik from is licensed by CC 3.0 BY