Skip to content

shravankumaruk/serverium-pro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Release License Stars Forks Issues Last Commit Repo Size Downloads Java Tested on JDK Platform

Serverium Pro Logo

Serverium Pro (SimpleServerApp)

A lightweight Java Swing application that serves static files over HTTP, logs requests, and provides an intuitive GUI for managing your local server.Can be used for testing your web applications easily and manage all requests save and view them for debugging too!


GitHub forthebadge forthebadge Java IntelliJ IDEA tested

🚀 Table of Contents

  1. Prerequisites

  2. Installation

  3. Usage

  4. Screenshots

  5. Contributing & Star the Project

  6. License


📋 Prerequisites

Before running Serverium Pro, ensure you have the following installed on your system:

  • Java Development Kit (JDK) 17 or later (tested on Oracle JDK 24)
  • Git (to clone the repository)

Verify Java installation:

java -version
javac -version

You should see output like java version "17" or higher (If its 24 then great).


🛠️ Installation

Windows 11

🖥️ Update:you can download the latest Windows ZIP (with ServeriumPro.exe ready-to-run) from the Releases section and simply unzip & launch.

  1. Install JDK

    • Download and install the latest JDK from Oracle or AdoptOpenJDK.
    • During setup, check Add to PATH.
  2. Clone the repository

    git clone https://github.com/shravankumaruk/serverium-pro.git
    cd serverium-pro
  3. Build the project

    javac SimpleServerApp.java
  4. Run the application

    java SimpleServerApp

Ubuntu / Debian / Kali Linux

  1. Install JDK & Git

    sudo apt update
    sudo apt install -y default-jdk
  2. Clone the repository

    git clone https://github.com/shravankumaruk/serverium-pro.git
    cd serverium-pro
  3. Build the project

    javac SimpleServerApp.java
  4. Run the application

    java SimpleServerApp

▶️ Usage

  1. Launch the GUI by running the application as shown above.
  2. Enter a port (above 1024).
  3. Select a directory to serve static files from.
  4. click Start Server
  5. Use Open Page to view the served content in your default browser.
  6. Save, View, or Clear logs using the respective buttons.
  7. Zoom In/Out in the log panel or use Ctrl + / Ctrl -.

📸 Screenshots

Start Server & Logs
Figure 1. Starting the server and initial log output.

Save Logs Dialog
Figure 2. Saving logs into a .srep file.

Main Tool Interface
Figure 3. Main interface showing controls and log panel.


🔧Maintenance & Support

I am committed to promptly updating this project in the event that any vulnerabilities or issues are discovered. Please report any problems or security concerns at: https://github.com/shravankumaruk/serverium-pro/issues

⭐ Contributing & Star the Project

Contributions are welcome! To help improve Serverium Pro:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/YourFeature)
  3. Commit your changes (git commit -m "Add YourFeature")
  4. Push to the branch (git push origin feature/YourFeature)
  5. Open a Pull Request

If you find this tool useful, please ⭐ star the repo:

GitHub • Serverium Pro


📝 License

This project is licensed under the GNU GPL v3.0. Feel free to use and modify, provided you retain the original credit and license notice.