RemoteLightWeb

Progressive Web Application for RemoteLight

Quick Start

Linux

• update system sudo apt-get update && sudo apt-get upgrade
• install java (min Java 8) sudo apt-get install openjdk-8-jre
• load the RemoteLightWeb Jar to the computer, for example via SFTP using WinSCP.
• start RemoteLightWeb: java -jar remotelightweb-1.0.4.jar
• it should have automatically created a config.properties file in the RemoteLightWeb folder
• the default ports (443 and 80) can be edited in the config.properties
• to stop it press Ctrl + c
• run in background: nohup java -jar remotelightweb-1.0.4.jar &
  or using screen: screen -dm -S rlweb java -jar remotelightweb-1.0.4.jar

Note: The program must be executed as root if the ports are <=1024. Therefore error messages may appear when running as non-root user. The ports can be edited in the config.properties to e.g. 8080 and 4443.

Run on startup

• open rc.local file: sudo nano /etc/rc.local
• paste the following right before exit 0:
  su - [user] -c "java -jar /path/to/remotelightweb-1.0.4.jar &"
  e.g. as 'pi' user: su - pi -c "java -jar /home/pi/remotelightweb-1.0.4.jar &"
• RemoteLightWeb should now run as background process after restart

Windows

• install java (min Java 8)
• download the RemoteLightWeb Jar
• open console: search cmd or press WINDOWS + R and type cmd.exe
• navigate to the directory where the RemoteLightWeb Jar is located: cd /path/to/remotelightweb
• start it: java -jar remotelightweb-1.0.4.jar
• it should have automatically created an config.properties in the RemoteLightWeb folder
• the default ports (443 and 80) can be edited in the config.properties
• press Ctrl + c to stop it

Mac

• install java (min Java 8)
• download the RemoteLightWeb Jar
• open terminal and navigate to the directory where the jar is located
• start it: java -jar remotelightweb-1.0.4.jar
• it should have automatically created an config.properties in the RemoteLightWeb folder
• the default ports (443 and 80) can be edited in the config.properties
• press Ctrl + c to stop it

Screenshots

Desktop

Mobile