# Install Homer Application Dashboard on Linux

## What is Homer?

> A dead simple static HOMepage for your servER to keep your services on hand, from a simple yaml configuration file. -https://github.com/bastienwirtz/homer

1. Log into the Linux device
2. Run the following commands in a terminal window
   # update software repositories
   sudo apt update
   # install available software updates
   sudo apt upgrade -y
   # install prerequisites
   sudo apt install git curl apache2 -y
   # add nodejs software repository
   curl -sL https://deb.nodesource.com/setup_16.x | sudo bash -
   # install nodejs
   sudo apt install nodejs -y
   # clone the homer git repository
   git clone https://github.com/bastienwirtz/homer.git ./homer
   # change directory to the source code
   cd homer
   # checkout the latest version
   git checkout "$(git tag --sort=v:refname | tail -n1)"
   # clean npm cache
   npm cache clean --force
   # install npm dependencies
   npm install
   # fix npm vulnerabilities
   npm audit fix
   # build homer
   npm run build
   # copy the sample config.yml
   sudo cp ./dist/assets/config.yml.dist ./dist/assets/config.yml
   # copy the dist directory to web root
   sudo cp ./dist /var/www/html/homer -r
3. Open a web browser and navigate to http://DNSorIP/homer
4. Welcome to Homer
5. To make changes to the dashboard, edit the config.yml file with the following command
   # edit homer config.yml
   sudo nano /var/www/html/homer/assets/config.yml
6. Press CTRL+O, Enter, CTRL+X to write the changes
7. Back in the web browser, refresh the page to view the changes