gunk1n / ssh_monitor

Website to monitor and view ssh connections

NETVISR SSH MONITOR

NETVISR SSH MONITOR is a React application that allows you to monitor SSH connections on machines. The application features a simple and user-friendly graphical interface.

---

🔗 Quick Links

• 📍 Overview
• 📦 Features
• 🚀 Getting Started
  • ⚙️ Installation
  • 🤖 Running
• 🤝 Contributing
• 📄 License

---

📍 Overview

Demo

SSH Monitor Screenshots

📦 Features

► Geo-location of IP addresses ► User-friendly interface ► Real-time monitoring of SSH connections ► Count of ssh connections

---

🚀 Getting Started

Requirements

Ensure you have the following dependencies installed on your system:

• Node.js: version 20.0.0
• rsyslog: version 8.2108.0

⚙️ Installation

1. Clone the repository:

git clone https://github.com/Joansitoh/ssh_monitor/

2. Change to the project directory:

cd ssh_monitor

3. Install the dependencies:

npm install

🤖 Running

Development Mode

If you want to run the application in development mode, you can use the following command:

npm run test

Production Mode

Running the application in production mode involves several steps:

1. Build the application:

npm run build

2. Copy the build output to the web server directory. This example uses Apache, so the target directory is /var/www/html. Adjust this command if you're using a different web server like Nginx:

cp -r dist/* /var/www/html/

3. Run the API server:

npm run api

Note: You need a web server like Apache2 or Nginx to serve the static files in production mode.

🤝 Contributing

Contributions are welcome! Here are several ways you can contribute:

• Submit Pull Requests: Review open PRs, and submit your own PRs.
• Join the Discussions: Share your insights, provide feedback, or ask questions.
• Report Issues: Submit bugs found or log feature requests for .

Contributing Guidelines

1. Fork the Repository: Start by forking the project repository to your GitHub account.
2. Clone Locally: Clone the forked repository to your local machine using a Git client.

   git clone https://github.com/Joansitoh/ssh_monitor/

3. Create a New Branch: Always work on a new branch, giving it a descriptive name.

   git checkout -b new-feature-x

4. Make Your Changes: Develop and test your changes locally.
5. Commit Your Changes: Commit with a clear message describing your updates.

   git commit -m 'Implemented new feature x.'

6. Push to GitHub: Push the changes to your forked repository.

   git push origin new-feature-x

7. Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.

Once your PR is reviewed and approved, it will be merged into the main branch.

---

📄 License

This project is protected under the MIT License. For more details, refer to the LICENSE file.

Return

---