diff --git a/README.md b/README.md index ea4e32b..bd01ec7 100644 --- a/README.md +++ b/README.md @@ -33,16 +33,28 @@ ATTENTION: This requires JDK 1.8 to run ATTENTION: Due to port 80 being the default, Linux restricts this to super user. Use the instructions below. ``` +<<<<<<< HEAD java -jar ha-bridge-4.1.0.jar +======= +java -jar ha-bridge-4.0.3.jar +>>>>>>> refs/remotes/origin/master ``` ### Automation on Linux systems To have this configured and running automatically there are a few resources to use. One is using Docker and a docker container has been built for this and can be gotten here: https://github.com/aptalca/docker-ha-bridge +<<<<<<< HEAD Create the directory and make sure that ha-bridge-4.1.0.jar is in your /home/pi/habridge directory. +======= +Create the directory and make sure that ha-bridge-4.0.3.jar is in your /home/pi/habridge directory. +>>>>>>> refs/remotes/origin/master ``` pi@raspberrypi:~ $ mkdir habridge pi@raspberrypi:~ $ cd habridge +<<<<<<< HEAD pi@raspberrypi:~/habridge $ wget https://github.com/bwssytems/ha-bridge/releases/download/v4.1.0/ha-bridge-4.1.0.jar +======= +pi@raspberrypi:~/habridge $ wget https://github.com/bwssytems/ha-bridge/releases/download/v4.0.3/ha-bridge-4.0.3.jar +>>>>>>> refs/remotes/origin/master ``` #### System Control Setup on a pi (preferred) For next gen Linux systems (this includes the Raspberry Pi), here is a systemctl unit file that you can install. Here is a link on how to do this: https://www.digitalocean.com/community/tutorials/how-to-use-systemctl-to-manage-systemd-services-and-units @@ -61,7 +73,11 @@ After=network.target [Service] Type=simple +<<<<<<< HEAD ExecStart=/usr/bin/java -jar -Dconfig.file=/home/pi/habridge/data/habridge.config /home/pi/habridge/ha-bridge-4.1.0.jar +======= +ExecStart=/usr/bin/java -jar -Dconfig.file=/home/pi/habridge/data/habridge.config /home/pi/habridge/ha-bridge-4.0.3.jar +>>>>>>> refs/remotes/origin/master [Install] WantedBy=multi-user.target @@ -96,7 +112,11 @@ Then cut and past this, modify any locations that are not correct ``` cd /home/pi/habridge rm /home/pi/habridge/habridge-log.txt +<<<<<<< HEAD nohup java -jar -Dconfig.file=/home/pi/habridge/data/habridge.config /home/pi/habridge/ha-bridge-4.1.0.jar > /home/pi/habridge/habridge-log.txt 2>&1 & +======= +nohup java -jar -Dconfig.file=/home/pi/habridge/data/habridge.config /home/pi/habridge/ha-bridge-4.0.3.jar > /home/pi/habridge/habridge-log.txt 2>&1 & +>>>>>>> refs/remotes/origin/master chmod 777 /home/pi/habridge/habridge-log.txt ``` Exit and save the file with ctrl-X and follow the prompts and then execute on the command line: @@ -140,6 +160,54 @@ Added the following lines to my Apache config file “000-default” ``` +service apache2 restart +### lighthttpd Example +``` +server.modules += ( "mod_proxy" ) +proxy.server = ( + "/api" => + ( + ( "host" => "127.0.0.1", + "port" => "8080" + ) + ) +) +``` +### nginx Example +``` +location /api/ { + proxy_pass http://127.0.0.1:8080/api; +} +``` +## Run ha-bridge alongside web server already on port 80 +These examples will help you proxy your current webserver requests to the ha-bridge running on a different port, such as 8080. +### Apache Example +Reverse proxy with Apache on Ubuntu linux: + +a2enmod proxy +a2enmod proxy_http +a2enmod headers + +Added the following lines to my Apache config file “000-default” + +``` + + ProxyPass /api http://localhost:8080/api nocanon + ProxyPassReverse /api http://localhost:8080/api + ProxyRequests Off + AllowEncodedSlashes NoDecode + + # Local reverse proxy authorization override + # Most unix distribution deny proxy by default (ie /etc/apache2/mods-enabled/proxy.conf in Ubuntu) + + Order deny,allow + Allow from all + + +….. (the rest of the VirtualHost config section) ….. + +``` + service apache2 restart ### lighthttpd Example ``` diff --git a/pom.xml b/pom.xml index e0c9dbc..d3340e8 100644 --- a/pom.xml +++ b/pom.xml @@ -6,7 +6,6 @@ com.bwssystems.HABridge ha-bridge 4.1.0 - jar HA Bridge