Skip to content
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Update sonarr tv plugin description in website Jan 17, 2019
models version 2019.07.1 Jul 21, 2019
notifications version 2019.07.1 Jul 21, 2019
plugins change css phase and goal Jul 21, 2019
updater version 2019.07.1 Jul 21, 2019
web change css phase and goal Jul 21, 2019
.gitattributes First commit May 21, 2016
.gitignore add google public calendar module Jul 24, 2016
DevelopPlugin.md Update DevelopPlugin.md Jan 22, 2019
README.md Update README.md Mar 8, 2019
pom.xml version 2019.07.1 Jul 21, 2019

README.md

HomeDash

Requirements

Build

  1. Java SDK 11
  2. Maven

Run

  1. Java 11

Run from distribution

From JAR file

First time you run the application, you'll need to generate a config file.

java -jar Homedash-{version}.jar -create-config

This will create a config file that you can modify in your current working directory.

You can then run

java -Dconfig.file=./homedash.properties -jar Homedash-{version}.jar

From docker

You can run homedash using docker.

docker run -t --name homedash \
        -v "/etc/localtime:/etc/localtime:ro" \
        -v "/your/path/to/save/data:/data" \
        -e "SALT=somerandomstring" \
        -p "4567:4567" \
        gonzague/homedash

Environment Variables:

Variable Description Required
SALT A random string used for authentication and other hashes YES
UID if you want to run the container under a different user id. Runs as root (0) by default no
GID The group id to run the container under. Runs as root (0) by default no
JAVA_OPTS configure the JVM no
SECURE "true" or "false" (default) to enable HTTPS no
KEY_STORE if SECURE="true" you need to specified the path of your keystore (jks) file within the container after you mounted it no
KEY_STORE_PASS the password to your key store file no
DEBUG Set to "true" to allow connection to the JMX to get visual vm debugging, if enabled you need to add the port map the port 4570 of the container as well. no
CONFIG You can define all the plugins and boards using this variable. It is a JSON format. You can generate this JSON from an existing instance of homedash at the url http://yourhomedashinstall:port/export-config no

Note that running Homedash in docker will have reduced feature when it comes to system monitoring due to the nature of docker containers.

How to build

mvn clean  install

The compiled application will be under web/target/Homedash-{version}.jar

Run from source with Maven

mvn -pl web exec:java

Develop plugin

If you're interested to develop a plugin, check DevelopPlugin.md

You can’t perform that action at this time.