# Run HomeDash - Server Monitor/Dashboard - on Linux

## What is Homedash?

> HomeDash is a simple dashboard that allows to monitor and interact with many different services in order to have a single entry point for one's dedicated server via a set of Plugins. It's easy to install, setup and use. -https://lamarios.github.io/Homedash2/

## Installing Java and Maven

1. Log into the Linux based device
2. Run the following commands in the terminal
   # update software respositories
   sudo apt update
   # install available software updates
   sudo apt upgrade -y
   # install java and maven
   sudo apt install default-jdk maven -y
   # check java version
   java --version
   # check maven version
   mvn -version

## Running HomeDash

1. Now that Java and Maven are installed, run the following commands to run HomeDash
   # create working directories
   sudo mkdir /opt/homedash2 -p
   # set owner of working directories
   sudo chown $USER:$USER /opt/homedash2 -R
   # change directory to the new folder
   cd /opt/homedash2
   # lookup latest homedash jar URL
   regex='"browser_download_url": "(https:\/\/github.com\/lamarios\/Homedash2\/releases\/download\/[^/]*\/Homedash-[^/]*\.jar)"' && response=$(curl -H "Accept: application/vnd.github.v3+json" https://api.github.com/repos/lamarios/Homedash2/releases/latest) && [[ $response =~ $regex ]] && downloadURL="${BASH_REMATCH[1]}"
   # download the latest release
   wget -O ./homedash.jar $downloadURL
   # generate a config file
   java -jar ./homedash.jar -create-config
   # run homedash
   java -Dconfig.file=/opt/homedash2/homedash.properties -jar homedash.jar
2. Open a web browser and navigate to http://DNSorIP:4567
3. Welcome to HomeDash

Documentation: https://github.com/lamarios/HomeDash2