# Running Monitorr Application Dashboard in Docker

## What is Monitorr?

> "Monitorr” is a self-hosted PHP web app that monitors the status of local and remote network services, websites, and applications. -https://github.com/Monitorr/Monitorr

## Installing Docker

1. Log into the Linux based device
2. Run the following commands in the terminal
   # install prerequisites
   sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y
   # add docker gpg key
   curl -fsSL https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)/gpg | sudo apt-key add -
   # add docker software repository
   sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(lsb_release -cs) stable"
   # install docker
   sudo apt install docker-ce docker-compose containerd.io -y
   # enable and start docker service
   sudo systemctl enable docker && sudo systemctl start docker
   # add the current user to the docker group
   sudo usermod -aG docker $USER
   # reauthenticate for the new group membership to take effect
   su - $USER

## Running Monitorr

1. Now that Docker is installed, run the following commands to setup the Monitorr Docker container and run it
   # create working directories
   mkdir ~/docker/monitorr -p
   # set owner of working directories
   sudo chown "$USER":"$USER" ~/docker -R
   # run the monitorr docker container
   docker run -d --name=monitorr -v ~/docker/monitorr:/app -e TZ=America/New_York -e PGID=1000 -e PUID=1000 -p 8090:80 --restart=on-failure monitorr/monitorr
2. Open a web browser and navigate to http://DNSorIP:8090
3. Click the Monitorr Settings link
4. Click the Monitorr Registration link
5. Click the Create button
6. Scroll down and complete the form to create an administrator username and password > Click Register
7. Click the Log in here link
8. Login with the credentials created earlier
9. Click Monitorr in the lower left corner of the page
10. Welcome to Monitorr

Documentation: https://github.com/Monitorr/Monitorr/wiki/02-Config:--Docker