Home is a mobile-ready, MEAN stack powered bookmark and service monitor.
- Provides transparency about the infrastructure and services you provide
- Provides simple monitoring of services
- Provides weather updates for your location
The application is a glorified bookmark manager that people on your network can access. The application scans the IP address's port to see if it is open, determining if the service is available.
There is an issue with addresses with port numbers and subdirectories e.g. https://172.23.4.2:8422/ibm/console/. When this is used, the application will sometimes report it as unavailable.
Home uses a number of open source projects to work properly:
- [MongoDB] - Database storing the sections and items
- [Express] - fast node.js network app framework
- [AngularJS] - HTML enhanced for web apps!
- [node.js] - evented I/O for the backend
- [Twitter Bootstrap] - great UI boilerplate for modern web apps
- [Winston] - awesome keyboard handler lib by [@thomasfuchs]
- [Portscanner] - scans for services running on a specific port
- [Skycons] - Nice icons for weather0
- [ForecastIO] - Weather
- I like to run my production Node programs on port 80. Install iptables if you do not have it.
sudo apt-get install iptables -y sudo iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 3000
Install the MEAN stack following these instructions from DigitalOcean: https://www.digitalocean.com/community/tutorials/how-to-install-a-mean-js-stack-on-an-ubuntu-14-04-server
Clone this repository
sudo apt-get install git-core -y git clone https://github.com/calvinbui/home.git
- You will need to install the dependencies for the program as well.
cd home npm install
Edit the config.json file to include your Forecast.io API key and location latitude and longitude
Run the application however you like:
sudo node server.js //using node sudo pm2 start server.js //using pm2 - recommended etc.
- Drag and drop reordering
- Pin notices e.g. power outage @ 5pm 13th of May